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LSENS, A GENERAL CHEMICAL KINETICS AND SENSITIVITY ANALYSIS 
CODE FOR GAS-PHASE REACTIONS: USER’S GUIDE 


Krishnan Radhakrishnan and David A. Bittker 
National Aeronautics and Space Administration 
Lewis Research Center 
Cleveland, Ohio 44135 


SUMMARY 

A general chemical kinetics and sensitivity analysis code for complex, homogeneous, gas-phase, 
chemical reactions is described. The code, LSENS, computes reaction progress efficiently and accurately for a 
variety of chemical reaction models. The models include: (1) static system, (2) steady, one-dimensional, 
inviscid flow, (3) shock initiated reaction, and (4) the perfectly stirred (highly backmixed) reactor. In addition, 
equilibrium computations can be performed for the following assigned states: (1) enthalpy and pressure, 

(2) temperature and pressure, (3) internal energy and volume, and (4) temperature and volume. 

Any reaction problem may be adiabatic, have an assigned heat transfer profile, or, for static and flow 
problems, have an assigned temperature profile. For static problems, either the density is constant or the 
pressure versus time profile is assigned. For flow problems, either the pressure or area may be assigned as a 
function of time or distance. 


For a static reaction, sensitivity coefficients of all dependent variables and their temporal derivatives 
with respect to initial values of dependent variables and/or rate coefficient parameters can be obtained. 

Other features of LSENS include the checking of the legality and sufficiency of all input. Also, at the 
user s option, the code checks the reaction mechanism for uniqueness and ensures that each reaction satisfies 
charge and atom balance requirements. 

This paper presents comprehensive descriptions of the code and its usage, including several illustrative 
example problems. 
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PART A 

INTRODUCTION 


1 



This report describes a new computer code, LSENS, the Lewis General Chemical Kinetics and Sensitivity 
Analysis Code. It also provides a detailed guide to the use of the code, as well as several illustrative test 
problems. This paper has been excerpted from the following three publications, which are in press: 

(a) Radhakrishnan, K., "LSENS - A General Chemical Kinetics and Sensitivity Analysis Code for Gas-Phase 

Reactions. I. Theory and Numerical Solution Procedures," NASA RP. 

(b) Radhakrishnan, K. and Bittker, D. A., “LSENS - A General Chemical Kinetics and Sensitivity 

Analysis Code for Gas-Phase Reactions. II. Code Description and Usage,” NASA RP. 


and 


(c) Bittker, D. A. and Radhakrishnan, K., “LSENS - A General Chemical Kinetics and Sensitivity 

Analysis Code for Gas-Phase Reactions. III. Illustrative Test Problems,” NASA RP. 

In particular, we have extracted from the above three papers much of the Introduction, all of chapters 8 to 13 
and appendices B and C and descriptions of the example problems listed in appendices D and E and provided 
with the code. The purpose of the present report is to provide an interim guide to the use of LSENS, prior to 
the publication of more detailed documentation, including the theory, numerical solution procedures and user’s 
manual (i.e., the above three papers). 

The code has been developed for solving complex, homogeneous, gas-phase, chemical kinetics problems. 
The motivation for this work is the continuing interest in developing detailed chemical reaction mechanisms for 
complex reactions such as the combustion of fuels and pollutant formation and destruction. A reaction 
mechanism is the set of all elementary chemical reactions (i.e., real molecular events) that are required to 
describe the process of interest (refs. 1 and 2). Mathematical descriptions of chemical kinetics problems 
constitute sets of coupled, nonlinear, first-order ordinary differential equations (ODEs) (refs. 1 and 3). The 
number of ODEs can be very large because of the numerous chemical species involved in the reaction 
mechanism. Further complicating the situation are the many simultaneous reactions needed to describe the 
chemical kinetics of practical fuels. For example, the mechanism describing the oxidation of the simplest 
hydrocarbon fuel, methane, involves over 25 species participating in nearly 100 elementary reaction steps 
(ref. 4). 

Validating a chemical reaction mechanism requires repetitive solutions of the governing ODEs for a variety 
of reaction conditions. Analytical solutions to the systems of ODEs describing chemistry are not possible, 
except for the simplest of cases, which are of little or no practical value. Consequently, there is a need for fast 
and reliable numerical solution techniques for chemical kinetics problems. 

Prior to the widespread availability of fast computers numerical results could be obtained only after 
substantial reduction and approximation of the reaction mechanism, which then had little resemblance to the true 
chemistry (refs. 5 to 7). Surprisingly, the introduction of digital computers after World War II did not result in 
significant advances in complex mechanism development, even though numerical integration methods for ODEs 
had been developed. The ODEs describing chemical kinetics exhibit a peculiar behavior (called “stiffness”) that 
makes their solution by classical ODE integration methods prohibitively expensive — i.e., classical methods will 
require prohibitive amounts of computer time to integrate chemical kinetics equations. 1 It is the development 


‘in this paper the terms computational expense (or cost) and execution time (i.e., CPU time) are used 
synonymously. 



of specialized solution techniques, as well as fast computers, that have made possible economical solutions of 
complex reaction problems. 

In addition to solving the ODEs describing chemical kinetics, it is often necessary to know what effects 
variations in either initial condition values or chemical reaction mechanism parameters have on the solution. 
Such a need arises in the development of reaction mechanisms from experimental data (ref. 8). The rate 
coefficients are often not known with great precision and in general, the experimental data are not sufficient y 
detailed to accurately estimate the rate coefficient parameters. The development of a reaction mechanism is 
facilitated by a systematic sensitivity analysis, which provides the relationships between the predictions o a 
kinetics model and the input parameters of the problem (refs. 3, 9, and 10). 


The code LSENS has been developed for efficient and accurate chemical kinetics computations and 
includes sensitivity analysis for a variety of problems, including nonisothermal conditions. LSENS replaces the 
previous NASA general chemical kinetics codes GCKP (ref. 1 1) and GCKP84 (ref. 12). The new code is 
designed for flexibility, convenience and computational efficiency. A variety of chemical reaction models can 
be considered. The models include: (1) static system, (2) steady, one-dimensional, inviscid flow, (3) reaction 
behind an incident shock wave, including boundary layer correction, and (4) the perfectly stirred (highly 
backmixed) reactor. In addition, computations of equilibrium properties can be performed for the following 
assigned states: (1) enthalpy and pressure, (2) temperature and pressure, (3) internal energy and volume and (4) 
temperature and volume. For static problems the code computes sensitivity coefficients with respect to the 
initial values of the dependent variables and/or the three rate coefficient parameters of the chemical reactions. 

To integrate the ODEs describing chemical kinetics problems LSENS uses the packaged code LSODE— the 
Livermore Solver for Ordinary Differential Equations (refs. 13 to 15)— because it has been shown to be the 
most efficient and accurate code for solving such problems (refs. 16 to 20). The sensitivity analysis computa- 
tions use the decoupled direct method (refs. 20 to 22), as implemented by Dunker (ref. 23) and modified by 
Radhakrishnan (ref. 22). This method has shown greater efficiency and stability, with equal or better accuracy, 
than other methods of sensitivity analysis (refs. 20 to 22). 


The rest of this paper is organized as follows. It is divided into two parts, B and C. Part B contains 
chapters 8 to 13 and appendices B and C of reference (b) cited above. This part describes LSENS, its usage 
and how to modify it. Chapter 8 describes the computational capabilities and convenience features built in o e 
code. Its structure and description are presented in chapter 9. In chapter 10 we list the modifications that may 
be required to implement the code on the user’s computer system. Chapter 1 1 provides a guide to its usage, n 
particular, we describe the preparation of the problem data file required to execute LSENS. The output 
information generated by the code is discussed in chapter 12. Example problems that illustrate both problem 
data construction and code usage are given in chapter 13. These examples supplement chapter 1 1 by prov.d.ng 
additional guidance into the preparation of the problem data file. 


Appendix B shows how to access the system clock for several common computing systems, so execution 
times can be measured. The modifications required to change the built-in values for several quantities are 
described in appendix C. 


Part C of this report describes the example problems provided with the code. It was abstracted from 
appendices D and E of reference (c) cited earlier. In appendix D we describe the kinetics-only test Problems 
supplied with the code. These problems illustrate the various reaction models that can be solved by LSEN5>. 
Finally, appendix E describes the kinetics-plus-sensitivity analysis test cases provided with the code. The test 
problems in the two appendices cover a variety of problem types and so should serve as useful models for the 
structure of the problem data file required to execute the code. Indeed, it is likely that the desired file can be 
produced by modifying one of the example problems. 
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CHAPTER 8 - COMPUTATIONAL CAPABILITIES OF CODE 


The LSENS code has been designed for the following reaction models and computations: 

(1) Static reaction either at constant density or with assigned pressure. 

(2) One-dimensional flow reaction with an assigned pressure or area profile. 

(3) Static or flow reaction with an assigned temperature profile. 

(4) Sensitivity analysis for a static reaction. 

(5) Equilibrium reaction. 

(6) Reaction initiated by an incident shock wave. 

(7) Reaction in a perfectly stirred reactor. 

Any kinetic reaction problem for which temperature is not assigned may either be adiabatic or have a prescribed 
rate of heat exchange with its environment. 

In this chapter we give a description of the computational capabilities of LSENS. We also discuss 
convenience features and the calculation procedures used for the thermodynamic and transport properties. 


Types of Chemical Reaction and Rate Coefficient 

Many different types of elementary chemical reaction are considered. In addition, provision has been made 
for both reversible and irreversible reactions. Each reaction is assumed to involve up to a maximum of two 
different reactant and two different product species and thus, can be written in the general form: 

Vj'Sj + v 2 'S 2 ^ v 3 "S 3 + v 4 "S 4 , (8.1) 

where v^ is the stoichiometric coefficient (i.e., number of moles) of reactant species i in the reaction, v" is 
the stoichiometric coefficient of product species i in the reaction and S ■ is the chemical symbol for species i. 

In equation (8.1) either species S 1 or S 4 or both may be either absent or the general third-body collisional 
partner M. Therefore all collisional processes, including isomerization and spontaneous activation and 
deactivation of excited species, are considered. In addition, photochemical reactions of the following type are 
allowed: 


hv + v 2 'S 2 v 3 "S 3 + v 4 "S 4 , (8.2) 

where hv represents a single quantum of radiation absorbed by the reactant. This reaction is an irreversible 
decomposition. 

All reactions are assumed to be elementary, that is, real molecular events (e.g., ref. 1), so the {v^} and 
{v/'} are integers. Also, all species are assumed to be ideal gases. For each reaction j, irrespective of its type, 
the forward rate coefficient kj is usually given by the empirical expression (ref. 2): 

kj = Aj T 0 ! exp(-Ej/RT). (8.3) 

In this equation the preexponential factor Aj, the temperature exponent nj and the activation energy Ej are 
constants, R is the universal gas constant and T is the temperature. Provision has also been made for the 
following alternate form of the rate coefficient expression (ref. 3): 
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k- = AjT n 'exp( Cj T), 


(8.4) 


where Cj is a constant. 

The backward rate coefficient k.j need not be specified for a reversible reaction. For both of the above 
forward rate coefficient expressions k.j is computed in the code by using the principle of detailed balancing or 
microscopic reversibility (refs. I and 4): 


k -j = V^j- (8.5) 

Here K cJ 19 1116 concentration equilibrium constant for reaction j and, for a given temperature, is computed as 
follows (ref. 4): 


,-An. 


K c j - (RT) Jexp(-AG°yRT). (8.6) 

In this equation Anj is the change in the total number of moles when the reactants are converted into products. 


2 2 


= E V - £ 

i=l i=l 


r U’ 


(8.7) 


where Vy' and Vy" are, respectively, the stoichiometric coefficients of reactant species i and product species i 
in reaction j. The term AG^j is the standard-state, that is, one-atmosphere, Gibbs function change for the jth 
reaction at temperature T, 


AG rj - E VtfCD - E Vy'tfCT), 


i=l 


i» 1 


( 8 . 8 ) 


wh-e gj(T) is the standard-state Gibbs function of species i at temperature T. The calculation procedure for 
£? is described in the section “Thermodynamic Properties.” 


Assigned Variable and Specification 

For a static problem either the density, p, is held constant or the pressure, p, is specified either as a 
constant or as a function of time, t. The following two methods for specifying the pressure-time profile are 
built into the code: (i) as a polynomial function of up to third degree, 

p(t) = + C u t + C (2 t 2 + C,/, ( 8.9) 

where the {C ( j} are constants and (ii) in tabular form, wherein the pressure p, (i = 1,...,N A ) is assumed to be 
given at each of the N A discrete points t; (i = 1,...,N A ). 

For a reacting flow problem either the pressure or the area. A, is assigned, either as a constant or as a 
function of time or distance, independently of the choice of the independent variable, §, for the governing 
ordinary^ differential equations (ODEs). For clarity in presentation we will refer to i; as the “integration 
variable”. To specify the “assigned variable” (pressure or area), that is, the variable that can be assigned as 
nonconstant, the two methods given above for a static problem are available. If we represent the assigned 


I 
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variable by Ay and the variable it is a function of by £ A the third-degree polynomial representation used in 
the code is given by: 


Av« a ) = c ?a> o*c ?a ^ a + c ?ai 2 ^.c ?ai35a 


( 8 . 10 ) 


where the {C p .} are constants. The second method requires values for £ Ai 0 = 1,—*N A ) and the correspond- 
ed 

ing A v | (i = 1,...,N A ) at the N A discrete points. 


For both static and reacting flow problems \ and its first-derivative dAy/di; must be evaluated for a 
given value of ^ (see the equations in appendix A). Because the p-t profile for a static problem is a particular 
case of the Ay-I; A profile for a flow problem, we restrict discussion to the latter case. However, there is one 
fundamental difference between the two cases. For static problems the variables 5 A (= t) and % (= t) are the 
same, whereas they may be different for a flow problem. We postpone to the section “Time and Distance 
Computations for Flow Problem” a description of how £ A is calculated, and will assume in the rest of this 
section that it is known. 


If the assigned variable profile is specified by a polynomial, its value is obtained from equation (8.10) and 
its first-derivative with respect to £ A is given by 


^ - 2C W 5 A . 3C tAi3 5 A 2 

The quantity dAy/dt; is then computed by using the chain rule of differentiation: 

dA v tl A y d£ A 

d£ d £ A d£ * 


( 8 . 11 ) 


( 8 . 12 ) 


When the assigned variable profile is specified in tabular form Ay and dAy/d£ A are determined by cubic 
spline interpolation with parabolic runout at the end conditions (e.g., refs. 5 and 6). The derivative dAy/di; is 
then given by equation (8.12). 


Assigned Temperature Problem 


The temperature, T, of the reacting system may be assigned for both static and flow problems, either as a 
constant or as a function of time or distance, independently of both 1; and 5 A . The same two methods 
described in the previous section for the assigned variable are built into the code for specifying the temperature. 


If we denote by the variable that T is assigned as a function of, the polynomial representation used 
in the code is given by 


T(5 t ) - + C £ t?1 St + c £ t ,2 5 t 2 + C 5 t ,3 S T > (8 - 13) 

where the (C* .} are constants. The tabular form of profile specification requires values for £ Ti 0 = 1,...,N X ) 
^T’J ’ 

and the corresponding Tj (i = 1,...,N T ) at the N T discrete points. In either case, T and its first-derivative 
dT/d£ must be evaluated for a given 1;. For a static problem = £ (= t); however, for a flow problem 
may be different from £ and, if so, is evaluated as described in the next section. 
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The procedures for computing T and dT/d£ are exactly the same as those described for the assigned 
variable in the previous section. For a polynomial representation T and dT/d^ T are obtained from equation 
(8.13). If the temperature is specified in tabular form the same cubic spline interpolation routine used to 
compute the assigned variable and its first-derivative gives T and dT/d^ x . In both cases, if * £, the chain 
rule of differentiation, analagous to equation (8.12), is used to calculate dT/dl;. 


Time and Distance Computations for Flow Problem 

As discussed in the previous two sections, for a reacting flow problem the independent variable, £ A , for the 
assigned variable (pressure or area) and/or the independent variable, fcp for the temperature may be different 
from the integration variable, i;. It is therefore necessary to compute the distance, x (time, t) when time 
(distance) is the integration variable. The most obvious way of accomplishing this objective is to treat distance 
(time) as an additional dependent variable when time (distance) is the integration variable and solve its ODE. 
For example, if time is the integration variable the ODE /or distance is given by 


dx 
d t 



x(t = t 0 ) - given. 


(8.14) 


where V is the velocity. However, this method introduces another ODE and increases the size of the iteration 
matrix. In the present work an alternate, easier calculation procedure, a cubic spline interpolation that is 
described below, is used to compute x (t) from t (x). 

The ODE solver used here generates numerical solutions at discrete points ^ (n - 1,2,...). We assume 
that time is the integration variable and that the solution has been advanced over the time step [t .,M of size 
h n ( = t n - t n _ | ) . We now assume that the velocity, V, varies locally, i.e., in the interval [t n _ ,,t n ], as a cubic 
polynomial: 

V(t) = a 0 + a,t + ajt 2 + ajt 3 , (8.15) 

where the constants (aj| have to be determined. By requiring that V and dV/dt satisfy the following 
constraints 


v <V = v n . 


dV 

~dt~ 




dV 

~dT 


it-t„ 


v „-l- 


= V 


n> 


(8.16) 
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where V n and V n are the numerical solution values for V and (dV/dt) at t = t () , we can solve for the four 
unknowns a 0 - a v Substituting the solutions for these quantities into equation (8.15) and rearranging 
terms we get 


V(t) - v n _, + (t - t n _,)V n _, + 


( v 

1 - Vi 


K - 3V n _, - h n v n - 2h n v n _,) 


't-v," 


(2V n - ZV^ - h„V n - h„V n -l 


(8.17) 


The derivatives V n _j and V n are obtained from the Nordsieck history arrays z n _j and z n , respectively. This 
history array contains the solution and its scaled derivatives. Substituting equation (8.17) into equation (8.14), 
integrating over the interval [t n l ,tj and Collecting terms give the following expression for x n : 


( 




Vi 

+ V n 

+ h 2 

V. - v n 

2 

n 

12 


(8.18) 


If distance is the integration variable we replace h n in the above equation by the difference 
(t n - t |), where t n-1 is known and t n has to be computed. Also, we replace the difference (x n - x n _j) by h n , 
the step length used on the interval [x n _j,x n ]. Finally, because x is the integration variable we use the chain 
rule of differentiation to replace dV/dt by V dV/dx (■ VV). The resulting equation can then be regarded as a 
quadratic equation in the quantity (t n - t n _j). Its solution is given by 


(>„ - Vi) - * V„) 



(8.19) 


where we have used the positive root to ensure that t increases as the integration proceeds. (Because the 
overall reaction problem is irreversible we can solve the governing ODEs for only increasing t). The difficulty 
with equation (8.19) is the possibility of overflows if V n .,V n .j - V n V n . For example, for constant velocity 
flow, V | ** V n , V n _j * V n (■ 0) and this condition is obtained. We avoid the above difficulty by multiplying 
both the numerator and denominator of the expression for (t n - t n _j), equation (8.19), by the quantity 



( . . \ 

y k 

i \2 

Vn-.V n -, - V n V„ 

(V , + V I + 

v , + V + 4h 

\ v n-l v n/ 11 n 

\ n-l n/ N 

3 J 


Performing this operation and then 


simplifying the resulting expression we get the following equation for t n : 



( 8 . 20 ) 


t 


n 




n - 1 





( , \ 

K-l * V n) * , 

K-, * V J 2 * «h„ 

V n-.V« " V n V„ 

N 


^ 3 y 


which avoids the problem of overflow errors. 


Heat Transfer Models 

The heat transfer rate between a reacting system and its surroundings is, in general, a function of the 
reacting gas and ambient temperatures, as well as flow rate and geometry. It is most likely that exact heat 
exchange rates will not be known when modeling an experimental reacting system. Therefore the main 
usefulness of the code will be in determining the effects of various assumed heat transfer rates. It was 
previously assumed (ref. 7) that the simplest expression for the heat loss rate is a polynomial function of the 
reacting mixture temperature. Therefore the standard option for specifying the heat transfer rate, 0, for a static 
problem or the heat transfer rate per unit length in direcion of flow, 0', for a flow problem is given by the 
polynomial expression. 


0 (or O') - H t o + H T ,T + H T 2 T 2 + H T 3 T 3 + H-^T 4 , (8.2 I ) 

where the (H T j} are constants. Note that 0 (or 0') can be made negative to simulate a heat source for an 
ignition problem. This heat transfer model is also used to compute the heat transfer rate for a perfectly stirred 
reactor problem. 

For one-dimensional flow problems another calculation procedure for 0' is included in LSENS. In this 
model 0' is given by the following empirical expression (e.g., ref. 8): 

0 * tfL w (T-T w ), (8.22) 

where H is the heat transfer coefficient (heat transfer rate per unit surface area per unit temperature differ- 
ence), L w is the perimeter of the flow cross-section and T w is the wall temperature. For a cylindrical tube of 
diameter D the cross-sectional area A ■ 7rD^/4, so 

L w = 7TD = 2 (8.23) 

Substituting this equation into equation (8.22) gives 

Q' - 2 ^A//(T -T w ). (8.24) 

There are many correlations that can be used to estimate H (e.g., ref. 8). For turbulent flow we use the 
following empirical correlation: 


HD 

K 


0.023Re°- 8 Pr° 3 


(8.25) 
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In this equation Re and Pr are, respectively, the Reynolds and Prandtl numbers: 


Re = PXP. 


(8.26) 


and 


Pr = 



(8.27) 


where p, c p and K are, respectively, the mixture dynamic viscosity, mass-specific heat at constant pressure 
and thermal conductivity. These properties are evaluated at the fluid bulk temperature (ref. 8), which is equal to 
the reacting fluid temperature for one-dimensional flow. The thermodynamic property c p and transport 
properties p and K for the mixture are computed by using the empirical equations given in the sections 
“Thermodynamic Properties” and “Transport Properties”, respectively. The correlation given by equation (8.25) 
is used for flows with Reynolds number > 2300. For laminar flows (Re < 2300), the following correlation is 
used (ref. 8): 


_ = 4.364. (8-28) 
K 


The above model is used to compute the heat transfer rate per unit mass of reacting mixture, Q/m, for one 
special static reaction application — the assigned-pressure, variable-volume reaction in the cylinder of an internal 
combustion or Otto-cycle engine. We assume that the cylinder has diameter B (bore) and length L s (stroke) 
and that heat transfer occurs only through the curved cylindrical surface. The heat transfer rate per unit mass of 
mixture is then given by 


q _ HA S (T - T w ) _ 4 H(T - T w ) 
m p V Bp 


(8.29) 


where A g is the instantaneous area of the curved surface, V is the instantaneous chamber volume and we have 
used the fact that V7A S = B/4 for a cylinder. To compute H we use the correlation of equation (8.25) or (8.28) 
with D replaced by B and the Reynolds number computed by (ref. 9) 

Re = pLsQB , (8-30) 

7TM 

where Q is the cranking angular velocity in radians per second and is calculated from the engine speed in 
revolutions per minute, RPM, by 
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ttRPM 

30 


(8.31) 


Thermodynamic Properties 

The thermodynamic properties of the species are computed by using the empirical equations given by 
Gordon and McBride (refs. 10 and 1 1). For each species i the nondimensional properties molar-specific heat 
at constant pressure (c p /R), molar-specific enthalpy (/i/RT) and the one-atmosphere molar-specific entropy 
(s®/R) are specified as functions of temperature in the form of least squares coefficients as follows: 


IT “ a i,l + a i*2 T + a i,3 T 


2 + a i,4T 3 + a i>5 T 4 , 


(8.32) 



*i,l 


\2 rp + \3 j2 + \4 j3 + 

2 3 4 


a i,5 t 4 + a i,6 
5 T ’ 


(8.33) 


o 



R 


a i l ln T + a i 2 T + 


a i>3 t 2 + 
~2 


V T 3 + ^5 x 4 + a 7 . 

3 4 ’’ 7 


(8.34) 


In the above equations R is the universal gas constant and the superscript “o” indicates standard conditions, 
i.e., pressure of one atmosphere. This superscript is not attached to the specific heat and enthalpy because the 
two properties are independent of pressure for ideal gases. 


For each species i the seven coefficients a^ - a i>7 are computed with the properties and coefficients 
(PAC) code of McBride and Gordon (ref. 12). For ideal gases this program first calculates thermodynamic 
properties from molecular constant data given in the JANAF thermochemical tables (e.g., ref. 13) and then 
reduces them to coefficient form. For each species two sets of coefficients for use on two adjacent temperature 
intervals, 300 to 1000 K and 1000 to 5000 K, are included. The data are constrained to give the same results at 
1000 K. 


Another thermodynamic property that is required for chemical kinetics computations is the standard state 
molar-specific Gibbs function (gf). The normalized Gibbs function (g°l RT) is given by 


O 



RT RT 


(8.35) 


The thermodynamic properties {dc p j/dT} may also be required and are obtained by differentiating equation 
(8.32) with respect to T. 



The thermodynamic properties of the reacting gas mixture are evaluated by applying Gibbs theorem (e.g., 
ref. 14), that is, by simply summing the contributions made by each species. Thus, for example, the mixture 
mass-specific enthalpy, h, is given by 


NS 

h - £ 0„ ™ 

i«l 

where o x is the number of moles of species i in unit mass of mixture and NS is the total number of (reacting 
and inert) species. 


Transport Properties 

The transport properties of the species are computed by using the empirical equations given by Zeleznik 
and McBride (ref. 9); see also Gordon et al. (refs. I 1 and 15). For each species i the dynamic viscosity |i| 
and thermal conductivity k x are specified as functions of temperature in the form used by Maitland and Smith 
(ref. 16): 


ln Mj “ a 4i ln T + 



(8.37) 


In Kj » a ; K ln T + 




(8.38) 


The coefficients in these equations are obtained by least-squares fitting and give viscosity in units of pg/cm-s 
and thermal conductivity in units of jjcal/s-cm-K. 

The transport properties p and k for the gas mixture are also computed by using the procedures given 
by Zeleznik and McBride (ref. 9). The mixture viscosity is calculated with the formula suggested by Wilke 
(refs. 17 and 18): 


where 


NS 

M - E Mi 


i*l 


NS 

E Vj 

j=i 


4 >. 



(8.39) 


(8.40) 
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where is the molar mass of species i. 

For the mixture thermal conductivity the formula proposed by Lindsay and Bromley (ref. 19) is used: 


NS 

<-E 


i= I 


NS 

E Vi 


j=l 


(8.41) 


where 


<J>ii - 4- 


i + 


( \ 

Mi 

A 


M, 


\V4 


wj 


^w.i 


( i + s/r x 


+ SyT 


1/2 


I + 


S i/T 


i + s/r 


(8.42) 


In this equation Sj is the Sutherland constant for the ith species and S- is the Sutherland interaction constant 
for the species i and j (refs. 9 and 15). S^ is obtained from the viscosity as follows (ref. 9): 


I + 


din p; 
din T 


Vi 


(8.43) 


where (din (J/dln T) is computed from equation (8.37). S- is generally assumed to be of the form (refs. 9 and 
15): 


Sjj “ Cy /SjSj , 


(8.44) 


where C- is a constant. Lindsay and Bromley (ref. 19) recommend a value C- - I, except when one of the 
species i and j is highly polar. For this case a value C- - 0.733 is suggested (ref. 9). We use C r » I for all 
pairs of species except those involving water, for which C- is set equal to 0.733. J 

Simplified Composition Input 

The initial mixture composition may be specified by means of the species mole fractions, x^ (i - I ,...,NS), 
or mass fractions, yj (i » 1,...,NS). The internal concentration variables, |Oj|, are then computed via 


1 ns 

E 

J=l 


= I NS. 


(8.45) 
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or 


G; = 


yi 


M, 


i = 1,...,NS. 


w,i 


(8.46) 


The code also includes the option of specifying the initial composition for any reaction involving the 

general hydrocarbon fuel, H n C> n , by the simple means of either the fuel-oxidant equivalence ratio, <j>, or 

the fuel-oxidant mass ratio, f/a. The oxidant may contain oxygen, nitrogen, argon, and carbon dioxide in any 

proportion. A “standard air” oxidant has been built into the code, but the user has the option of changing it. 

The composition of this oxidant is given in table 8.1. Its molar mass is 28.9644. The quantities Xj and in 

table 8.1 are the mole and mass fractions, respectively, of species i in the oxidant, and is the ratio of the 
mole fraction of oxidant species i to that of oxygen: 


r i = 



(8.47) 


For the standard air given in table 8.1, it is the {/••} values that are built into the code. 

To obtain the relations between species mole fractions and (j) or f/a we use the stoichiometric 
fuel-oxygen reaction: 


C H O, 


4n, 


+ n H 2n 0 


O 2 — k n c C0 2 


■h 


H.O, 


(8.48) 


TABLE 8.1. - STANDARD OXIDANT 
COMPOSITION BUILT INTO LSENS 
[Molar mass = 28.9644] 


Species, 

Si 

Mole 

fraction, 

Mass 

fraction, 

yi 

Mole 

fraction ratio, 

r . (= V^o 2 ) 

n 2 

0.78088 

0.75524 

3.727350 

°2 

0.20950 

0.23145 

— 

Ar 

0.00932 

0.01285 

0.044487 

co 2 

0.00030 

0.00046 

0.001432 
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which is valid for any fuel with (4^ + n H ) > 2n Q . The ftiel-oxidant equivalence ratio is defined as 


(F/O)/ 

where F/O is the actual fuel-oxygen molar ratio and (F/0) s is its stoichiometric value. It is clear from 
reaction (8.48) and the definition of 4> that 

x f _ 4<j> 

x 0 2 4n c + n H 2n o 

where the subscript u f’ denotes fuel. 

Now, the mole fraction of each oxidant species i in the fuel-oxidant mixture is related to Xq via 

x i = r i x o 2 ’ 

which together with equation (8.50) and the identity 


V X 0 2 * x N 2 * x Ar* x C0,-'’ 


give the following expression for x„ : 

Uo 


x o 2 - 


4n C + n H " 2n O 


44) + (4n c ♦ n H - 2n Q ) (l + r Nj + 


The fuel and oxidant species mole fractions can then be computed by using equations (8.50) and (8.51). 
Finally, equation (8.45) gives the {Oj}. 

If the fuel-oxidant mass ratio is specified, we first compute x^/Xq using the relation 

A = M w^ f/a) 

x 0 2 M w,f x 0 2 

where the subscript “air” denotes oxidant and 


02 1 + r N 2 + ''Ar + r C0 2 

Equation (8.50) then gives <j), from which the initial mixture composition can be computed by using the 
procedure described above. 


(8.49) 


(8.50) 


(8.51) 


(8.52) 


(8.53) 


(8.54) 


(8.55) 
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Net Reaction and Species Formation Rates 


The relative importance of the jth reaction to the formation or destruction rate of the ith species can he 
gauged by examining its net reaction rate per unit volume, rj, and the time rate of change of Oj due to the jth 
reaction, (do/dt) . However, these rates are converted to more useful quantities as follows. For each reaction j 
the code computes the net reaction conversion rate, Xj, defined as 


X * Fj 

J 7' 


(8.56) 


where ij is given by 


r j R j R_ j' 


(8.57) 


Here R and R_ are, respectively, the molar forward and reverse rates per unit volume of reaction j. The larger 
magnitudes of the |Xj| make it easier to use them to compare net reaction rates than the |ij). The net molar 
rate of formation of species i per unit volume by reaction j, to-, defined by 


CO; 


P 







(8.58) 


is also generated. The jtO; } are useful in developing a chemical kinetic mechanism because they show which 
reactions are important in forming or destroying a given species. 


Equilibration Factor 


It is often important to know how far a chemical reaction is from its equilibrium condition. To determine 
the state of the jth reaction we derive a simple equilibration factor from rj, equation (8.57). Now, rj will be 
positive or negative depending on the magnitudes of Rj and R_j. If Rj is greater than R_j, we divide 
equation (8.57) by Rj to get 


r j = i _ R -j 
Rj Rj 


(8.59) 


If the reaction were far from equilibrium, Rj will be significantly larger than R_j and the ratio rj/Rj will be a 
positive number very close to unity. If the reaction is near equilibrium, Rj “ R_j and rj/Rj * s a positive number 
close to zero. Therefore, v^R- varies between 0 and 1 for the extreme situations of equilibrium (Rj - R.j) and 
irreversibility (Rj ” 0). 
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If, however, R ■ is greater than R jt we divide equation (8.57) by R to get 


J _ 


R_ 


I, 


(8.60) 


and the ratio r/R_ } varies between 0 and -1 for the extreme conditions of equilibrium (R = R ) and 
irreversibility (Rj = 0). J J 

The 1WO ratios, equation. (8.59) and (8,60), can be combined inn, a .ingle equilibration factor, ^ 


qo 



(8.61) 


where the bars 1 1 denote absolute value and 0 <i 
effect of a single reaction on the entire complex 


E qj < 1 . The equilibration factor is useful in determining the 
process, and is computed for each chemical reaction. 



CHAPTER 9 - CODE ORGANIZATION AND DESCRIPTION 


The present version of the LSENS code, dated July 22, 1992, is in double precision. It is compatible with 
most FORTRAN 77 compilers. However, it contains detailed instructions on how to convert it to FORTRAN 
66. The MAIN subprogram lists all routines requiring modifications. Also, in each such routine both the 
changes and the lines where they must be made are given. 

The code was developed on the NASA Lewis Research Center’s IBM 370/3033 computer using the TSS 
operating system (OS) and the Amdahl 5870 computer using the UTS OS. It has also been successfully 
executed on the following computer systems: NASA Lewis Research Center’s Amdahl 5870 using the 
VM/CMS OS, Cray-X/MP/2/4 using the COS and UNICOS operating systems and the CFT and CFT77 
compilers, Cray-Y/MP/8/6128 using UNICOS 6.0 and CFT77, the Alliant FX/S, the Convex C220 minicomputer 
using the Convex 8.0 OS, and the VAX 1 1/750, 1 1/780, 1 1/785, 6320, 8650, 8800, and 9410; NASA Ames 
Research Center’s Cray-2 and Cray-Y/MP using UNICOS and CFT77; the SUN SPARCstation 1 using the Sun 
4.1 OS; and the IBM RISC System/6000 using the AIX 3.1 OS and the XLF and F77 compilers. 

The code consists of a MAIN subprogram, 59 subprograms and a BLOCK DATA module. Table 9.1 lists 
these subprograms in the order that they appear in the code and briefly describes them. The subprograms 
SECCPU, DDOT, D1MACH, IDAMAX, and VNORM are function routines; all others are subroutines. Also, 
the routine CUBS contains statement functions. The function SECCPU, which computes the incremental CPU 
time in seconds, calls the system clock to obtain the total CPU time used since initiation of the job. The code 
uses the following intrinsic and external routines: ALOG, DABS, DBLE, DEXP, DFLOAT, DLOG, DMAX1, 
DMIN1, DSIGN, DSQRT, EXP, FLOAT, IABS, IFIX, MAX0, MIN0, MOD, READ, SNGL, and WRITE. 
Finally, the subroutines INIT, KINP, TINP, and SENSIN use namelists. 

The different subprograms that comprise the LSENS package are arranged in three different blocks or 
groups as follows. The first group contains the MAIN subprogram and those (CIMAGE - WSR) related to 
thermodynamic, transport and kinetics computations. The second group includes the subroutines (SENDDM - 
SNSTAB) required for sensitivity analysis. The last group contains the subprograms (LSODE - XSETUN) 
included in the code LSODE (refs. 20 to 22), which is used to solve the governing ordinary differential 
equations (ODEs). Within each group the subprograms are arranged alphabetically. The BLOCK DATA 
module is located at the end of the code. 

LSENS has been arranged as much as possible in a “modular” fashion, with different subprograms 
performing different tasks. However, to avoid unnecessary work, some computations are performed in 
subprograms other than where they naturally belong. An example is the calculation of the thermodynamic 
properties dr /dT (i = 1,...,NS), where c pi is the constant-pressure molar-specific heat of species i, T the 
temperature and NS the total number of (reacting and inert) species. These derivatives are needed only for the 
computation of certain elements of the Jacobian matrix (see eq. (9.2)), which is required for the numerical 
integration of the ODEs and sensitivity analysis. Hence, they are computed in the subroutine PEDERV, which 
computes the Jacobian matrix, and not in the subprogram THRM, which computes all other thermodynamic 
properties of the species (table 9.1). 

Because the code is designed to be modular the number of subprograms is fairly large. However, this 
feature aids in both understanding and, if necessary, modifying the code. In addition, as improvements are 
made in any calculation procedures or methods built into the code, only the subprograms using these procedures 
need to be replaced. An example is the computation of thermodynamic data. The relations built into the code 
are based on fitting data over two temperature ranges. Work is now underway to extend the temperature range 
over which the calculations are valid and requires the use of several temperature ranges (ref. 12). To 
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TABLE 9.1. - DESCRIPTION OF SUBPROGRAMS USED IN LSENS 


Subprogram 

Description 

MAIN 

Manages solution of the problem by calling the chemical kinetics preprocessor, the integrator 
or the perfectly-stirred reactor solver, and the output subprograms. Also computes CPU 
times and prints them. 

CIMAGE 

Reads in and prints an image of the input data for each case. 

COMB 

Manages the calls for equilibrium calculations. Also computes CPU time for this calculation 
and prints it. 

CUBS 

Computes assigned variable or temperature and its first-derivative using either user-supplied 
polynomial equation or a cubic spline fit of user-provided table of values. 

DIFFUN 

Computes derivatives of the dependent variables with respect to the independent variable. 

ELEMNT 

Computes element concentrations in atoms/gram of mixture. 

EQLBRM 

Performs equilibrium computations for: (a) assigned pressure and enthalpy, (b) assigned 
pressure and temperature, (c) assigned density and internal energy, and (d) assigned density 
and temperature. 

GAUSS 

Solves a set of linear equations using Gaussian elimination. 

HETRAN 

Computes heat loss terms and, if necessary, reads in viscosity and thermal conductivity data. 

INIT 

Reads in initial values of species concentrations and thermodynamic and flow variables. 

KINP 

Processes and checks validity of all input data including the reaction mechanism but not the 
temperature profile for an assigned temperature problem or sensitivity analysis data. At the 
user’s option, tests reaction mechanism uniqueness and atom/charge balance of each 
reaction. 

MATRIX 

Sets up matrices used in equilibrium computations. 

OUT1 

Prints all input information including reactions and rate coefficient parameters. 

OUT2 

Prints general output for kinetics and sensitivity problems and equilibrium solution for 
perfectly stirred reactor problem. 

PEDERV 

Computes elements of the Jacobian matrix. 

RKTOUT 

Computes and prints rocket performance parameters. 

RXNTAB 

Tabulates and prints reaction numbers in order of decreasing importance for each species 
(i.e., decreasing rates of production of each species by the reactions) and prints all nonzero 
rates of production by each reaction for every species. 
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SECCPU Computes CPU time increment in seconds. 

SHOCKS Solves the incident shock equations for equilibrium and frozen cases. 

SHOK Manages the setup and subprogram calls for incident shock calculations. Also, computes 

and prints CPU times for equilibrium and frozen shock calculations. 

SPLINE Performs a cubic spline fit using the first-derivative method with parabolic runout for end 
conditions. 

SPOUT Prints results of shock and equilibrium problems. Also transfers frozen shock results to the 

input of a shock-kinetics problem and, if necessary, computes the characteristic shock tube 
reaction length. 

THRM Computes nondimensional thermodynamic properties of the species. 

TINP Processes and checks validity of temperature-related data for assigned temperature problem. 

WSOUT Prints perfectly stirred reactor solution. 

WSR Performs perfectly stirred reactor computation. 

SENDDM Main integration and sensitivity solution driver. Manages call to core integrator and 

sensitivity subprograms that set up work array pointers and initialize sensitivity arrays. 

DFDP Computes partial derivatives of the temporal derivatives of the dependent variables with 

respect to sensitivity parameters. 

DMACHK Sets up real and integer work array pointers for core integrator and sensitivities, and checks 
that storage requirements are met. 

DMINIT Initializes sensitivity arrays. 

DMINTR Interpolates for sensitivity coefficients and their derivatives at output times. 

DMPJAC Computes iteration matrix and manages subprogram call for its LU-decomposition. 

DMPRNT Prints storage and computational work requirements for sensitivity analysis. 

DMSTOD Advances sensitivity solution by one time step. 

SENSIN Processes and checks validity of input data for sensitivity computations. 

SNSOUT Computes and normalizes sensitivity coefficients when pressure sensitivities are not required. 
Prints normalized sensitivity coefficients. 

SNSPSC Computes and normalizes sensitivity coefficients when pressure sensitivities are required. 

SNSTAB Tabulates and prints reaction numbers in order of decreasing importance (i.e., normalized 

sensitivity ) and the nonzero normalized sensitivity coefficients for each dependent variable. 
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LSODE 

Main core integration routine. Checks legality of input, sets work array pointers, initializes 
work arrays, computes initial integration time step, manages solutions of ODEs for both 

kinetics problems and sensitivity coefficients, and returns to calling routine with solutions 
and errors. 

CFODE 

Sets method coefficients for the solution and test constants for local error test and step size 
and order selection. 

DAXPY 

Forms the sum of one vector and another times a constant. 

DDOT 

Computes the dot product of two vectors. 

DGBFA 

Performs LU-decomposition of a banded matrix by Gaussian elimination. 

DGBSL 

Solves a linear system of equations using a previously LU-decomposed banded matrix. 

DGEFA 

Performs LU-decomposition of a square matrix by Gaussian elimination. 

DGESL 

Solves a linear system of equations using a previously LU-decomposed square matrix. 

DSCAL 

Scales a vector by a constant. 

D1MACH 

Computes unit roundoff of the computer. 

EWSET 

Sets the error weight vector. 

IDAMAX 

Identifies vector component of maximum absolute value. 

INTDY 

Computes interpolated values of the specified derivative of the dependent variables. 

PREPJ 

Computes the iteration matrix and manages subprogram call for its LU-decomposition. 

RSCOM 

Restores contents of common blocks LS0001 and EH0001. 

SOLSY 

Manages the solution of the linear system arising from chord iteration. 

STODE 

Advances the solution of the ODEs for the model problem by one integration step. Also, 
computes step size and method order to be attempted on the next step. 

SVCOM 

Stores contents of common blocks LS0001 and EH0001. 

VNORM 

Computes weighted root-mean-square norm of a vector. 

XERRWV 

Handles error messages from the LSODE package and the sensitivity routines DMACHK 
DMINTR and DMSTOD. 

XSETF 

Resets print control flag for error messages from XERRWV. 

XSETUN 

Resets logical tape unit number for error messages from XERRWV. 




incorporate the new calculation procedure into LSENS only THRM has to be replaced, and suitable modifica- 
tions made to PEDERV and appropriate common blocks. 

Communication among different subprograms is accomplished by means of both calling sequences and 
common blocks, which are used extensively in LSENS. The common blocks, if any, used by each subprogram 
are given in table 9.2. This table also lists all subprograms called and referenced (e.g., an external function) by 
each subprogram. Also, to facilitate the use of LSENS in overlay situations all subprograms that call and 
reference each subprogram are listed. Finally, for each subprogram the table gives entry names in parentheses 
and dummy procedure names (which are passed in calling sequences and have to be declared external in each 
calling and called subprogram) in brackets. Although we have listed only those common blocks that are 
actually used by the MAIN subprogram, it contains every common block used in the code so that it may be 
used in overlay situations. 

All the common blocks used in the code are listed in alphabetical order in table 9.3. The reason for using 
common blocks is to avoid lengthy calling sequences, which can significantly deteriorate the efficiency of the 
program. Also given in table 9.3 are the variables contained in each common block and their dimensions, if 
different from unity. To further assist in user understanding and modification of the code we have included in 
this table the names of all subprograms that use each common block. It must be pointed out that not all 
variables listed for a given common block are needed by each routine that uses it. For this reason some 
subprograms may use dummy names which are not listed in table 9.3, and variables with the same names may 
be declared to be of different lengths in different routines. 

Each subprogram contains type declarations for all variables used in it. Such declarations are useful for 
debugging and provide a list of all variables that occur in a routine. This list is useful in overlay situations (ref. 
23). The type declarations are arranged in a specific order to enhance their utility. At the beginning of each 
routine the variables are listed in blocks of statements, with each block corresponding to a particular data type. 
The variable types are listed in the following order: character, logical, integer, real, and double precision. 
Within each block of data type the variables are usually listed in the following order, variables that are passed 
in the call sequence, local array variables, variables appearing in common blocks, and finally local scalar 
variables. In some of the sensitivity and integration subprograms and in the BLOCK DATA module the above 
order is not followed strictly. Instead, we have placed together blocks that belong to the same program group; 
however, character variables, if any, are always listed first. For variables that appear in each common block we 
have, in general, used a separate data type statement. For a given data type these declarations are listed in the 
same order as the common blocks. Also, in virtually all data type declaration statements the variables are listed 
in alphabetical order. 

The variable type declaration statements are followed by DIMENSION statements. We first list variables 
included in the call sequence, then variables that appear in namelists and finally the local array variables. 
Following the DIMENSION statements, if any, all common blocks are listed in alphabetical order. Again, in 
some subroutines this order is not strictly followed and common blocks that belong to the same program group 
are placed together. However, within each such set the common blocks are listed alphabetically. The common 
block list is followed by equivalence statements, if any, and then by any namelists. Within each namelist the 
variables are ordered alphabetically. However, the namelists themselves are listed in the order that they are 
read. Following the namelists are DATA statements for local variables and, finally, any functions that are 
internal to the routine. 
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TABLE 9.2. - ROUTINES WITH COMMON BLOCKS, SUBPROGRAMS AND CALLING SUBPROGRAMS 


Subprogram 

[Dummy 

procedure 

name] 

(Entry 

names) 

Common block(s) used 

Subprogram(s) called 
and referenced 

Calling 
subprogram (s) 

MAIN 

COND 

DIRECT 

GEAR9 

DIFFUN 

KINP 

OUT1 




LS0001 

LS0002 

LTUS 

OUT 2 

PEDERV 

RXNTAB 




MISC 

NECC 

ODECON 

SECCPU 

WSR 

SENDDM 




OPTS2 

PRIN 

PROP 

DFDP 

DMPRNT 

SNSOUT 




SAVRAT 

SENNOR 

SENPAR 

INTDY 






SENVAR 

SINT 







CIMAGE 

LTUS 






KINP 


COMB 

COND 

INDX 

LTUS 

ELEMNT 

EQLBRM 

SECCPU 

KINP 



MISC 

NECC 

OPTS2 

SPOUT 






POINTS 

SPECES 







CUBS 

AFUN 

COND 

LTUS 

SPLINE 



DIFFUN 

KINP 

(CINP) 







TINP 


DIFFUN [F] 

COND 

CUBASV 

CUBTMP 

CUBS 

HETRAN 

THRM 

MAIN 

WSR 

(DIFFW, 

GHSC 

LTUS 

NECC 




DMSTOD 

LSODE 

DIFF1) 

ODECON 

OPTS1 

OPTS2 




PREPJ 

STODE 


PROP 

RATLOG 

REAC2 







RRAT 

SABS 

SINT 







SPCONC 

SPEC2 

STCS 







TRAN 

TRAN 2 

ZERCON 






ELEMNT 

COND 

INDX 

MISC 




COMB 

SHOK 


SPECES 






WSR 


EQLBRM 

COND 

GHSC 

INDX 

GAUSS 

MATRIX 

THRM 

COMB 

SHOCKS 


LTUS 

MATX 

MISC 




WSR 



NECC 

OPTS2 

POINTS 







SPECES 








GAUSS 

COND 

INDX 

MATX 




EQLBRM 

WSR 

HETRAN 

COND 

GHSC 

LTUS 




DIFFUN 

KINP 

(HTWSR, 

NECC 

OPTS1 

PDDTRM 






VISCON) 

SPECl 

SPEC2 

TRAN 







TRAN 2 
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INIT 

COND 

FAIRl 

FAIR2 




KINP 


LTUS 

NECC 

ODECON 






OPTSl 

OPTS 2 

SAVRAT 






SINT 

SPEC1 

SPEC2 





KINP 

AFUN 

COND 

CUBASV 

CIMAGE 

COMB 

CUBS 

MAIN 

(WSFLIP, 

CUBTMP 

ELMNTS 

FAIRl 

HETRAN 

INIT 

SHOK 


RINP) 

GHSC 

INDX 

INERT1 

THRM 

TINP 

SENSIN 



INERT2 

KOUT1 

KOUT2 






LS0002 

LTUS 

MISC 






NECC 

ODECON 

OPTSl 






OPTS 2 

PDDTRM 

PRIN 






PRIN2 

PROP 

RATLOG 






REAC1 

REAC2 

RMTHOK 






ROKET 

RRAT 

SABS 






SAWAR 

SENVAR 

SINT 






SPECES 

SPECl 

SPEC2 






STCS 

TCOF 

TRAN 






TSTNOS 

XVST2 

XVSAl 

XVSA2 





MATRIX 

COND 

GHSC 

INDX 




EQLBRM 


MATX 

MISC 

NECC 






OPTS 2 

POINTS 

SPECES 





OUTl 

AFUN 

COND 

CUBASV 




MAIN 


CUBTMP 

FAIR2 

GHSC 






INERT2 

KOUT1 

KOUT2 






LS0002 

LTUS 

NECC 






ODECON 

OPTSl 

OPTS2 






PRIN 

PROP 

REAC1 






REAC2 

ROKET 

RRAT 






SAWAR 

SENNAM 

SENNOR 






SENPAR 

SENVAR 

SINT 






SPEC1 

STCS 

TRAN 






XVSAl 

XVST2 

XVSA2 

XVST1 





OUT 2 

AFUN 

COND 

GEAR9 

RKTOUT 



MAIN WSR 

(OUTSTR , 

GHSC 

INERT2 

KOUT1 





OUT3) 

KOUT2 

LTUS 

NECC 






ODECON 

OPTSl 

OPTS2 






PROP 

REAC2 

ROKET 






SABS 

SAVRAT 

SINT 






SPCONC 

TRAN 

SPECl 

SPEC2 
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COND 

GHSC 

LTUS 

MATX 

NECC 

ODECON 

0PTS1 

OPTS2 

PDDTRM 

PROP 

REAC2 

RRAT 

SABS 

SPCONC 

STCS 

TCOF 

TCOF2 

TRAN 

TRAN 2 

ZERCON 


COND 

LTUS 

ROKET 

COND 

LTUS 

ODECON 

OPTS1 

REAC2 

SENPAR 

SPEC1 

SPEC2 



WSR DMPJAC 
PREPJ 


MAIN 


COND 

GHSC 

INDX 

LTUS 

MISC 

NECC 

POINTS 

SPECES 


COND 

LTUS 

MISC 

NECC 

POINTS 

SPECES 

AFUN 

COND 

CUBASV 

GHSC 

INDX 

KOUTl 

LTUS 

MISC 

NECC 

OPTS 2 

POINTS 

SPECES 

SPEC1 



COND 

GHSC 

LTUS 

TCOF 

TCOF2 


COND 

CUBTMP 

KOUTl 

LTUS 

OPTS1 

OPTS2 

PRIN 

PRIN2 

SABS 

SAVTMP 

SAWAR 

TSTNOS 

XVST1 

XV ST 2 


COND 

KOUT1 

LTUS 

MISC 

NECC 

PROP 

SPEC1 

SPEC2 

TRAN 

COND 

GHSC 

INDX 

KOUT2 

LTUS 

MATX 

MISC 

NECC 

ODECON 

PROP 

REAC2 

SPECES 

SPEC1 

SPEC2 

TRAN 


System CPU Clock 


EQLBRM THRM 


MAIN 

SHOK 


ELEMNT SECCPU SHOCKS KINP 
SPOUT 


COMB 

WSR 


COMB SHOK 


DIFFUN EQLBRM 
KINP SHOCKS 
SPOUT WSR 


DIFFUN ELEMNT EQLBRM MAIN 
GAUSS OUT2 PEDERV 

SECCPU THRM WSOUT 
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SENDDM 

COND 

DFDPA 

DIRCT2 

DIFFUN 

PEDERV 

DFDP 


DIRECT 

SENSOL 

PRIN 

SENPAR 

DMACHK 

DMINIT 

LSODE 

DFDP 

COND 

DFDPA 

GHSC 





NECC 

ODECON 

OPTS2 





RRAT 

SABS 

SENPAR 





SENVAR 

SPEC2 





DMACHK 

DIRECT 

SENPAR 


XERRWV 



DMINIT 

DIRECT 
SEN PAR 

LS0001 

PRIN 




DMINTR 

DIRECT 

LS0001 

SENPAR 

XERRWV 




SENSOL 

SENVAR 





DMPJAC 




DGEFA 

PEDERV 


DMPRNT 

DIRECT 

EH0001 





DMSTOD 

DFDPA 

DIRCT2 

DIRECT 

DIFFUN 

PEDERV 

DFDP 


LS0001 

SENPAR 

PRIN 

SAVRAT 

DMPJAC 

SOLSY 

XERRWV 

SENSIN 

COND 

LTUS 

ODECON 





OPTS 2 

REAC2 

SENNAM 





SENPAR 

SENVAR 

SPEC1 




SNSOUT 

DIRECT 

GHSC 

LS0001 

DMINTR 

SNSPSC 

SNSTAB 

(SNSOT2) 

LTUS 

NECC 

OPTS2 





PRIN 

RRAT 

SENNAM 





SENNOR 

SENPAR 

SENSOL 





SENVAR 

SINT 

TSTNOS 




SNSPSC 

DIRECT 

GHSC 

LS0001 

DMINTR 




NECC 

ODECON 

PRIN 





RRAT 

SAVRAT 

SENNOR 





SENPAR 

SENSOL 

SENVAR 





SINT 

TSTNOS 





SNSTAB 

LTUS 

SENNAM 

SENPAR 





SENSOL 

SENVAR 





LSODE 

COND 

DIRECT 

LS0001 

DIFFUN 

PEDERV 

DFDP 


SINT 



DMINTR 

DMSTOD 

D1MACH 





EWSET 

INTDY 

PREPJ 





SOLSY 

XERRWV 

STODE 

VNORM 

CFODE 








MAIN 

DMSTOD 

SENDDM 

SENDDM 

SNSOUT SNSPSC 
LSODE 

DMSTOD 

MAIN 

LSODE 

KINP 

MAIN 

SNSOUT 

SNSOUT 

SENDDM 

STODE 
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DAXPY 







DGBFA 

DGBSL 








DGEFA 

DGESL 

DDOT 







DGBSL 

DGESL 

DGBFA 




DAXPY 

DSCAL 

IDAMAX 

PREPJ 


DGBSL 




DAXPY 

DDOT 


SOLSY 


DGEFA 




DAXPY 

DSCAL 

IDAMAX 

DMPJAC 

PREPJ 

DGESL 




DAXPY 

DDOT 


SOLSY 


DSCAL 







DGBFA 

DGEFA 

D1MACH 







LSODE 


EWSET 







LSODE 


IDAMAX 







DGBFA 

DGEFA 

INTDY 

COND 

GEAR9 

LSOOOl 

XERRWV 



MAIN 

LSODE 


LTUS 

VELDOT 

ODECON 

OPTS1 






PREPJ 

COND 

LSOOOl 


DIFFUN 

PEDERV 

DGBFA 

STODE 


[ PJAC ] 




DGEFA 

VNORM 



RSCOM 

EH0001 

LSOOOl 







SOLSY 

LS0001 



DGBSL 

DGESL 


DMSTOD 

STODE 

[ SLVS ] 








STODE 

COND 

DIRECT 

GEAR9 

DIFFUN 

PEDERV 

CFODE 

LSODE 



LS0001 

VELDOT 

ODECON 

OPTS1 

PREPJ 

SOLSY 

VNORM 



SVCOM 

EH0001 

LSOOOl 







VNORM 







LSODE 

STODE 

PREPJ 

XERRWV 

EHOOOl 






DMACHK 

DMINTR 








DMSTOD 

INTDY 

LSODE 

XSETF 

EH0001 








XSETUN 

EHOOOl 








BLOCK DATA 

DIRECT 

EHOOOl 

KOUT1 







LSOOOl 

LTUS 

NECC 







OPTS1 

REACl 

SPEC1 







TCOF2 

TSTNOS 








I 
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TABLE 9.3. - COMMON BLOCKS WITH VARIABLES AND SUBPROGRAMS 



AFUN LSUBM ETA D VISC BETA SHOCK CUBS KINP OUT1 OUT2 

SPOUT 


COND SIGMA(50) T RHO V DVAR AREA MAIN COMB CUBS DIFFUN 

MDOT P IV AR LS LSPI LSP2 LSP3 ELEMNT EQLBRM GAUSS HETRAN 

NEXT FLPROB INIT KINP MATRIX OUT1 

OUT2 PEDERV RKTOUT RXNTAB 
SHOCKS SHOK SPOUT THRM 
TINP WSOUT WSR SENDDM 
DFDP SENSIN LSODE INTDY 
PREPJ STODE 

CUBASV CUBX(IOO) CUBY(IOO) CUBM(IOO) CN(4) DIFFUN KINP OUT l SPOUT 

NTB ITPSZ IPRCOD 

CUBTMP CUBXT(IOO) CUBYT(IOO) CUBMT(IOO) DIFFUN KINP OUT1 TINP 

CNTMP(4) NTTB ITTSZ ITRCOD 

DFDPA DFDPJ(52,750) SENDDM DFDP DMSTOD 

DIRCT2 NFIRST LSCALL SENDDM DMSTOD 

DIRECT DMHO DMELU(13) JDMOPT JDMJAC MAIN SENDDM DMACHK DMINIT 

JSTRDM JDMJEV JDMADD JDMDEV DMINTR DMPRNT DMSTOD 

IDIRC2 NDMSEN IDMNOR IDMJAC SNSOUT SNSPSC LSODE STODE 

IDMY2 JDMIA NRSTOT NISTOT BLOCK DATA 

NSTDM NFEDM NJEDM 

EHOOOI MESFLG LUNIT DMPRNT RSCOM SVCOM 

XERRWV XSETF XSETUN 
BLOCK DATA 


ELMNTS ELNAM(15) KINP 

FAIR1 FUEL INTT KINP 

FAIR2 SCC SCH SCOX ERATIO NOXRAT INTT OUT1 

FLAIR ARAT CRAT AIRMW FR02 

GEAR9 HUSED NQUSED NSTEP NFE NJE VN MAIN OUT2 INTDY STODE 

PDVAR TDVAR 

GHSC DLTX TXR GRT(50) HRT(50) SR(50) DIFFUN EQLBRM HETRAN KINP 

CPR(50) DCPR(50) MATRIX OUT1 OUT2 PEDERV 

SHOCKS SPOUT THRM WSR 
DFDP SNSOUT SNSPSC 
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INDX NLM IQ1 IQ2 IQ3 KMAT IMAT COMB ELEMNT EQLBRM GAUSS 

COMBUS HP TP CONVG KINP MATRIX SHOCKS SPOUT 

WSR 

INERT1 DISNM(50) KINP 

INERT2 NINERT KINP OUT1 OUT2 

KOUTI UNIT TITLE(20) UNTTI UNITO FPS SI KINP OUT1 OUT2 SPOUT TINP 

CGS W SOI JT BLOCK DATA 

KOUT2 CONC EXCHR DELH(250) DBUGO KINP OUT1 OUT2 WSR 

LS0001 ROWND CONIT CRATE EL(13) MAIN DMINIT DMINTR DMSTOD 

ELCO(13,I2) HOLD RC RMAX SNSOUT SNSPSC LSODE INTDY 

TESCO(3,12) ELO H HMIN HMXI HU PREPJ RSCOM SOLSY STODE 

TN UROUND ILLIN INIT LYH LEWT SVCOM BLOCK DATA 

LACOR LSAVF LWM LIWM MX STEP 
MXHNIL NHNIL NTREP NSLAST NYH 
IALTH IPUP LMAX MEO NQNYH 
NSTEPJ IER JSTART KFLAG L METH 
MITER MAXORD N NQ NST NFE NJE 
NQU 

LS0002 HINIT HMAX HMIN MAXORD MAIN KINP OUT1 

MXSTEP MXHNIL 

LTUS LTHM LREAD L WRITE LDAT LTRAP MAIN CIMAGE COMB CUBS 

LSCR NTHRD NBLANK NPHOTO DIFFUN EQLBRM HETRAN INIT 

KINP OUT1 OUT2 PEDERV 
RKTOUT RXNTAB SHOCKS SHOK 
SPOUT THRM TINP WSOUT 
WSR SENSIN SNSOUT SNSTAB 
INTDY BLOCK DATA 


MATX 

GA(5 1 ,52) GX(5 1 ) 

EQLBRM GAUSS MATRIX 
PEDERV WSR 

MISC 

TT HRO ENN SUMN ENNL PP CPRO 

MAIN COMB ELEMNT EQLBRM 


ELNO(15) NITER 

KINP MATRIX SHOCKS SHOK 
SPOUT WSOUT WSR 

NECC 

SSUM MIXMW RATM M2 GAMMA 

MAIN COMB DIFFUN EQLBRM 


TCPR RERG RCAL 

HETRAN INIT KINP MATRIX 
OUT1 OUT2 PEDERV SHOCKS 
SHOK SPOUT WSOUT WSR 
DFDP SNSOUT SNSPSC 
BLOCK DATA 
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ODECON 


NRS NRSP1 NRSP2 NSODE NSODP1 
NTEQ NRHEQ NVEQ NODES SKIPTR 
TREQD RHREQD NOJTRH VREQD 


OPTS1 


OPTS2 


PDDTRM 

POINTS 

PRIN 


VERSI TIMEV VERSA AREAV 


RHOCON TASS RXORDR ACONST 
PCONST TGIVEN TCONST 


PDDSIG(50) PDDT PDDRHO PDDV 

PMLOG DLVTP DLVPT HSUM CCPR 
GAMMAF WM 

PRINT(IOO) NPRNTS END PST AT PASSV 
PTEMP IPRINT 


MAIN DIFFUN INIT KINP 
OUT I OUT2 PEDERV RXNTAB 
WSR DFDP SENSIN SNSPSC 
INTDY STODE 

DIFFUN HETRAN INIT KINP 
OUT1 OUT2 PEDERV RXNTAB 
TINP INTDY STODE 
BLOCK DATA 

MAIN COMB DIFFUN EQLBRM 
INIT KINP MATRIX OUT1 
OUT2 PEDERV SPOUT TINP 
DFDP SENSIN SNSOUT 

HETRAN KINP PEDERV 

COMB EQLBRM MATRIX SHOCKS 
SHOK SPOUT 

MAIN KINP OUT1 TINP 
SENDDM DMINIT DMSTOD SNSOUT 
SNSPSC 


PRIN2 APRINT(IOO) PRINT(IOO) END KINP TINP 

PROP EIN EOUT VOLUME SI SF RHOI GAMI MAIN DIFFUN KINP OUT1 

WM DELMD DELT MASS MPR OUT2 PEDERV WSOUT WSR 

DOTMAX TMPMIN DTMAX RITE 
WSFLOW WELSTR WSRHTR 

RATLOG DAFLOG(250) DIFFUN KINP 

REAC1 EQUAL KINP OUT1 BLOCK DATA 

REAC2 LSR(4,250) XX(250) DPX(2,250) MM(35) DIFFUN KINP OUT1 OUT2 

RATE(250) BRATE(250) LR LRTYPE(250) PEDERV RXNTAB WSR SENSIN 
LR3RD(35) NS3RD(35) I3RD( 10,35) 

RMTHOK RMFINE THFINE KINP 

ROKET PC ATHROT ROCKET KINP OUT1 OUT2 RKTOUT 

RRAT A(250) N(250) EACT(250) M( 10,35) DIFFUN KINP OUT1 PEDERV 

NUM(250) NTBR ALLM1 DFDP SNSOUT SNSPSC 

SABS SI AA BB S2 DTERM TTERM DA DT DIFFUN KINP OUT2 PEDERV 

MWARN TINP DFDP 
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SAVRAT 

FF(53) 

MAIN INIT OUT2 DMSTOD 
SNSPSC 

SAVTMP 

XTB(IOO) TTB(IOO) TMPTB(IOO) CX(4) 
CT(4) TPRINT(IOO) 

TINP 

SAVVAR 

CXTB(IOO) CATB(IOO) CXTTB(IOO) 
CTMPTB(IOO) IPRSAV(4) ITRSAV(2) 
HT(5) WSRHT(5) ACON PCON TCON 

KINP OUT1 TINP 

SENNAM 

SNAMES(2,53) 

OUT1 SENSIN SNSOUT SNSTAB 

SENNOR 

SIVNP(52) SRPNP(3) YINV(52) 

MAIN OUTl SNSOUT SNSPSC 

SENPAR 

SCIV(53,52) SCRP(53,250,3) NPARR(3) 
IDPAR(2,52) NREAC(250) NRPOUT 

MAIN OUTl RXNTAB SENDDM 
DFDP DMACHK DMINIT DMINTR 
DMSTOD SENSIN SNSOUT SNSPSC 
SNSTAB 

SENSOL 

DYDY0(52,52) SENSE(53j250,3) 

SENDDM DMINTR SNSOUT SNSPSC 
SNSTAB 

SENVAR 

TINY SENCAL SENSIV SENSRP SENSAJ 
SENSNJ SENSEI SENSTD SENP 
SENOUT SNORDR 

MAIN KINP OUTl DFDP 
DMINTR SENSIN SNSOUT SNSPSC 
SNSTAB 

SINT 

TKSAVE EMAX ATOLSP MF MAXSTP 
NH AVH MMHG MOLEF 

MAIN DIFFUN INIT KINP 
OUTl OUT2 SNSOUT SNSPSC 
LSODE 

SPCONC 

C(50) CSUM 

DIFFUN OUT2 PEDERV 

SPECES 

EN(50) ENLN(50) DELN(50) ELSP( 15,50) 

COMB ELEMNT EQLBRM KINP 
MATRIX SHOCKS SHOK SPOUT 
WSR 

SPEC1 

DSNAM(3) DSPNM(50) EFFM BLANK 
HNU TAPEND TBSPNM( 10,35) 

HETRAN INIT KINP OUTl 
OUT2 RXNTAB SPOUT WSOUT 
WSR SENSIN BLOCK DATA 

SPEC2 

MW(50) W(50) STOIC(50,250) 
OMEGA(50,250) 

DIFFUN HETRAN INIT KINP 
OUT2 RXNTAB WSOUT WSR 
DFDP 

STCS 

NSTOIC(4,250) NSPRP(2,250) 

DIFFUN KINP OUTl PEDERV 

TCOF 

TC(50,7,2) TLOW TMID THI TPREV 

KINP PEDERV THRM 


TCOF2 THCX(5) THDCX(3) THHCX(5) THSCX(5) PEDERV THRM BLOCK DATA 
KTHRM 
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TRAN 

DD HTRAN TWALL TOTMAS PQMRHO 
PQMT QDOTM OTTO STROKE RPM 
BORE QMREAD HTC(5) WSHTC(5) NTR 
VTC(4,50,2) ICV(50) VCSP(50,2) FDSQ2 
IH20 KOUNT 

DIFFUN HETRAN KINP OUTI 
OUT2 PEDERV WSOUT WSR 

TRAN2 

GAMM1 GM1DG 

DIFFUN HETRAN PEDERV 

TSTNOS 

SMEST TESTNO NLMAX LSMAX 
LRMAX LSRMAX TBRMAX TBSMAX 
NTBMAX NPMAX 

KINP TINP SNSOUT SNSPSC 
BLOCK DATA 

VELDOT 

TOLD VDOT 

INTDY STODE 

XVSAI 

XU AU(2) 

KINP OUTI 

XVSA2 

XTB(IOO) ATB(IOO) CX(4) 

KINP OUTI 

XVST1 

XTU TU 

OUTI TINP 

XVST2 

XTTB(IOO) TMPTB(IOO) CTMP(4) 

KINP OUTI TINP 

ZERCON 

FBRATE(2,250) LZEROC 

DIFFUN PEDERV 


The remainder of this chapter deals with the description of the code. To facilitate description of the many 
functions and options built into it, we separate the code into seven major sections, where each section performs 
a different task. These sections are as follows: (1) control, (2) input/output, (3) numerical integration 
procedure, (4) sensitivity analysis, (5) chemical equilibrium computation, (6) incident shock computation, and 
(7) perfectly stirred reactor computation. In addition, thermodynamic properties, heat transfer rates and transport 
properties are computed in separate sections, by using the procedures described in chapter 8. 

For each of the above seven sections we first describe its function and then, because they have already 
been described in table 9.1, only list the subprograms used. The discussion is focused mainly on the special 
features and built-in options. However, we provide detailed flowcharts to explain the computational procedures; 
in addition, structural diagrams are given for each section. We conclude this chapter with a brief discussion of 
the error messages included in the code. 


Control Section 

The control section contains the MAIN subprogram and, as discussed in later sections, to some extent, the 
subroutines COMB, SHOK, SENDDM and LSODE. The MAIN subprogram provides for problem setup via a 
series of subroutine calls. It calls for input and output of the reaction mechanism and other problem options. It 
also calls the appropriate subroutine, WSR or SENDDM, depending on the problem type — perfectly stirred 
reactor (PSR) or kinetics/sensitivity analysis. For the latter problem type the MAIN subprogram also manages 
the calls for solution output and computes and prints the CPU times. 

The structure of the LSENS code is given in figure 9.1, wherein a line connecting two routines indicates 
that the lower routine is called by the upper one and names in parentheses are ENTRY names. This notation is 
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Figure 9.1 —Structure of the LSENS code 























used in all the structural diagrams presented in this chapter. The dashed lines connecting the routines LSODE 
with XERRWV and DMINTR indicate that other routines not shown in this figure are also called by LSODE. 
We do not include these other routines because we take up the structure of the LSODE package in a later 
section. Figure 9.1 gives all the routines called by SENDDM because it provides some control of the 
integration. The subroutines called by DIFFUN are also included because of its importance. 

A detailed flowchart of the MAIN subprogram is given in figure 9.2. An important feature of LSENS is 
its capability to perform multiple cases in a single run. This option is most useful when several runs have to be 
made with the same reaction mechanism but with different problem types or initial conditions. Another option 
that controls the integration concerns the printout of results. The solution is generated at either intervals of a 
prescribed number of integration steps or the output stations £ out £ out 2 > — > where £ is the integration vari- 
able (i.e., independent variable for the ODEs). 


Input/Output 

The input/output section is called for all problem types. It reads, processes and checks the validity of all 
initial conditions and all input data, except those concerned with sensitivity analysis. It also prints all input 
data and initial conditions, and prints and checks the validity of solutions generated by the numerical integration 
method. In addition, an option is available to tabulate and print reaction numbers in order of decreasing 
importance for each species and print all nonzero production rates of every species by each reaction. The 
subprograms that comprise this section are CIMAGE, INIT, KINP, OUT1, OUT2, RKTOUT, RXNTAB, TINP, 
and BLOCK DATA. The routines related to output for sensitivity analysis, equilibrium, incident shock, and 
PSR calculations are considered in later sections. 

The most important subroutine in this section is KINP, whose structure and flowchart are given in figures 
9.3 and 9.4, respectively. This subroutine initializes various parameters, sets standard options and reads all 
options and input data, except those specified for sensitivity analysis and the temperature profile for an assigned 
temperature problem. The code has built-in standard choices for many of its options to minimize the amount of 
input data required. For the same reason, for a repeat case most of the data specified for the previous problem 
are saved. 

For an assigned temperature problem KINP calls TINP to process the temperature profile and other 
optional inputs. For example, LSENS includes an option whereby output can be required at specified values of 
the temperature, if it is assigned in tabular form as a monotonic function of the integration variable. In this 
situation, TINP calls CUBS to compute corresponding values of the integration variable. 

Another option that is included in KINP is that the rate coefficient for any third-body collisional reaction 
may be adjusted to account for different efficiencies of different third-body species. The standard choice, which 
is automatically set in KINP, is a collisional efficiency of unity. Thus, only collisional efficiencies that are 
different from unity need to be specified. For each three-body reaction KINP builds up a table of third-body 
species and their collisional efficiencies that are different from unity. Any species for which an efficiency value 
of unity is given is deleted from this table. 

KINP automatically builds up lists of reacting species and their constituent elements (atoms, etc.) as it 
processes each reaction. Thus, the user need not specify separate lists of elements and reacting species. A list 
of inert species is, however, required. Also, in specifying third-body species names there is no requirement that 
this species has already appeared in a reaction. However, after all reactions and inert species names have been 
processed the routine verifies that every third-body species has indeed appeared either as a reacting or an inert 
species. In addition, the routine checks that the user has not specified a noncatalytic reacting species as inert. 
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Figure 9.2.— Flowchart of the MAIN subprogram 
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Figure 9.4.— Ftowc hart of subroutine KINP. 












KINP also confirms that third-body efficiencies have been specified only for a third-body reaction and that 
the efficiency list follows the reaction. If the list is inserted before the reaction the routine will give an error 
message and stop execution. However, if a third-body reaction precedes the one for which the list is intended 
such testing is impossible, unless a third-body efficiency list had already been processed for it. 

KINP includes an option to check the legality of the reaction mechanism. When this option is selected the 
code verifies that no reaction is duplicated and that each reaction satisfies charge and atom balance require- 
ments. For example, reaction duplication may arise because the same reaction is written in different forms in 
different regions of the input file. However, we feel that such testing, which adds to the expense of running the 
code, is only necessary when the user is either developing or preparing a new mechanism. For this reason we 
have made it optional, and for a repeat case that uses exactly the same mechanism as the previous case the 
option is switched off by KINP (even if it had been selected for the previous problem). However, to avoid an 
error exit for apparently inexplicable reasons, for each repeat case KINP checks that the formerly specified 
mechanism was valid. If, for any reason, it had been found to be illegal, a message stating this fact is printed 
and the execution halted. 

The same two actions, that is, printing an error message and terminating execution, are taken by KINP for 
a repeat case if either illegal or insufficient thermodynamic data had been supplied for the previous problem. 

The final test of the reaction mechanism ensures that no superfluous reaction has been included. Such a 
condition arises when some reactions contain species which can neither be formed nor destroyed by the 
mechanism, and so will always have forward and reverse (and hence, net) rates of zero. An example is the 
modeling of H 2 -0 2 reaction with an H 2 -0 2 -N 2 mechanism. This problem may also arise because some elements 
of reacting or inert species have not been initialized (to nonzero concentrations). The error is not considered 
fatal; a message describing the problem will be printed but the execution will not be terminated. 

Following the above testing of the reaction mechanism, KINP identifies the problem type, checks the 
legality and sufficiency of all input data and converts them to internal (cgs) units. A choice of three systems of 
units, cgs, U.S. customary, and SI, is provided for both input and output. The choices for input and output units 
are independent of one another, so either the same or different units for input and output can be selected. 

Output may be required at specified values of the assigned variable (pressure or area), if it is given in tabular 
form as a monotonic function of the integration variable. In such a case, KINP calls CUBS to compute 
corresponding values of the integration variable. 

An important function of KINP is that for a kinetics-only problem (i.e., no sensitivity analysis required) it 
sets the number, N, of ODEs that must be solved. The ODE set contains ODEs for only those variables that are 
both required for a given problem and vary during the course of the integration. Thus, we do not solve ODEs 
for variables that are (a) not required (e.g., velocity for a static problem), (b) specified (e.g., temperature for an 
assigned-temperature problem), and (c) constant (e.g., inert species mole numbers). The ODE set therefore 
contains the minimum number of ODEs required to solve the problem. Not including the above variables 
increases the efficiency of the ODE solution for two reasons: (1) it avoids unnecessary calculations of 
derivatives and Jacobian matrix elements and (2) the size of the system is smaller, thereby decreasing the cost 
of both LU-decomposing (e.g., ref. 6) the iteration matrix (see eq. (9.3)) and solving for the corrections at each 
iteration. 

If sensitivity analysis is required, KINP calls the routine SENSIN, which processes all options and input 
data relevant to sensitivity analysis, and is described in the section “Sensitivity Analysis”. 

Finally, KINP processes the initial conditions and, if necessary, converts them to internal (cgs) units. It 
also checks the legality and sufficiency of the initial conditions. Moreover, it checks that the problem is not 
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overspecified. If a chemical equilibrium computation is required, KINP calls subroutine COMB, which manages 
these Taku^kTs ^ P ° St ' ShOCk condltlons are squired, KINP calls the subprogram SHOK, which manages 


Numerical Integration Procedure 

, , TJlf cod ® LSENS uses double precision version (dated June 17, 1980) of the packaged code LSODE 
(refs 20 to 22) to solve the stiff ODEs arising in combustion chemistry. LSODE includes a variable-step 
variable-order implicit Adams method (suitable for nonstiff problems) of orders 1 to 12, and a variable-step 
variable-order backward differentiation formula method (suitable for stiff problems) of orders 1 to 5 The user 
may, however, specify a smaller value than used in the code for the maximum order to be attempted on any 


Irrespective of the solution method the code starts the integration with a first-order method and, as the 
integration proceeds, automatically adjusts the method order (and step length) for optimal efficiency while 
satisfying prescribed accuracy requirements. Both integration methods employ a predictor-corrector scheme 
wherein on each step > an initial guess for the solution vector at is first produced and then 

the guess is improved upon by iteration. That is, improved estimates Y„ [m J (m = 1,2,...) are computed until the 
iteration converges. A standard explicit predictor formula, a Taylor series expansion method devised by 
Nordsieck (ref. 24) is used to generate Y,» 0 . To correct this estimate a range of iteration techniques is 
included in LSODE. Both the basic integration method and the corrector iteration procedure are selected bv 
means of the method flag MF. By definition, MF has the two decimal digits METH and MITER, and 


MF = 10 (METH) + MITER. 


(9.1) 


In this equation the integers METH and MITER indicate, respectively, the integration method and corrector 

1 teC . hn ‘ qUe to be used for the P roblem - Table 9.4 summarizes the integration methods included in 

LSODE and the appropriate values for METH. The legal values for MITER and their meanings are given in 
table 9.5. The Jacobian matrix (J) referred to in this table is an NxN matrix, with element J defined as 


J ij = af / a yj’ ij = 1....N, 

where y ; is the ith (i = 1,...,N) dependent variable and f f = dy/d^. 


(9.2) 


TABLE 9.4. - SUMMARY OF INTEGRATION METHODS 
INCLUDED IN LSODE AND CORRESPONDING VALUES OF 

METH 


METH 

Integration method 

1 

Variable-step, variable-order, implicit Adams method 
of orders 1 through 12. 

2 

Variable-step, variable-order, implicit backward 
differentiation formula method of orders 1 through 5. 
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TABLE 9.5. - CORRECTOR ITERATION TECHNIQUES AVAILABLE IN 
LSODE AND CORRESPONDING VALUES OF MITER 


MITER 

Corrector iteration technique 

0 

Functional iteration. 

1 

Modified Newton iteration with user-supplied analytical Jacobian 
matrix. 

2 

Modified Newton iteration with internally-generated numerical 
Jacobian matrix. 

3 

Modified Jacobi-Newton iteration with internally -generated numerical 
Jacobian matrix. 

4*,b 

Modified Newton iteration with user-supplied banded Jacobian matrix. 

5“ 

Modified Newton iteration with internally-generated banded Jacobian 
matrix. 


“The user must supply the lower (ML) and upper (MU) half-bandwidths of 
the Jacobian matrix (ref. 22). 

b This option should not be used with the present version of LSENS. 


The LSODE package consists of the main core integration routine, also called LSODE, and the 21 
subprograms CFODE, DAXPY, DDOT, DGBFA, DGBSL, DGEFA, DGESL, DSCAL, D1MACH, EWSET, 
IDAMAX, INTDY, PREPJ, RSCOM, SOLSY, STODE, SVCOM, VNORM, XERRWV, XSETF, and XSETUN. 
Of these subprograms, LSENS makes no use of the routines RSCOM, SVCOM, XSETF, and XSETUN. The 
structure of the LSODE package is given in figure 9.5, wherein the dashed lines indicate the modifications made 
to this code to compute sensitivities and names in brackets are dummy procedure names. 

The main routine LSODE controls the integration and serves as an interface between the calling 
subprogram and the rest of the package. Its flowchart is given in figure 9.6, where IT ASK and 1ST ATE are 
user-supplied indices that specify, respectively, the task to be performed and the state of the calculation, that is, 
if the call to LSODE is the first one for the problem or if it is a continuation (ref. 22). It must be pointed out 
that the figure shows only those LSODE options used by LSENS. On return from LSODE, the value of 
1ST ATE indicates if the integration was performed successfully, and if not, the reason for failure. The variable 
TOUT is the next £ value at which output is required. Finally, JSTART is an internally defined variable used 
for communicating the state of the calculation with the routine STODE. 

An important feature of LSODE is that it will compute the step length to be attempted on the first step if 
the user chooses not to provide a value for it. Another useful feature is that different integration methods can 
be used in different subintervals of the problem. For example, the heat release period, especially the early part, 
is not stiff (refs. 25 to 30) and it may be more efficient to switch to a nonstiff method in this regime (ref. 31). 
The code LSENS does not exploit this feature because of the lack of reliable regime identification tests and the 
same method is used for the whole problem. 
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Figure 9.5 — Structure of the LSODE package (adapted from refer- 
once 22). 
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C start ) 



Figure 9.6 — Flowchart of subroutine LSODE, as used by LSENS (adapted from reference 22). 
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The routine STODE advances the solution to the ODEs by a single integration step. In addition, it 
computes the method order and step length that together maximize efficiency while maintaining prescribed 
accuracy. To increase the efficiency of the calculation procedure, the solution history, which is required by the 
multistep methods used in LSODE (ref. 22), is saved in the form suggested by Nordsieck (ref. 24). The 
Nx(q+1) Nordsieck history matrix z n .j at contains the numerical solution Y^i and the q scaled 
derivatives ^Y^^Vi! (j = l,...,q), where h (= £ n - £ n l ) and q are the current step size and method order, 
respectively, and = d , Y/dl; J . The flowchart of STODE, again as used by LSENS, is presented in figure 9.7, 
which essentially illustrates how the history matrix is advanced over the step K„_|,i; n ]. In this figure K FLAG 
is an internally-defined flag used for communication with LSODE, z n |01 is the predicted history matrix at £ 
and P, an NxN iteration matrix that arises from Newton iteration, is given by " 

P = 1 - hpQj, (9.3) 

where I is the NxN identity matrix and (3 0 is a method coefficient that depends on the integration method 
and method order (ref. 22). The integer counter IALTH indicates how many more steps are to be taken with 
the current step size and method order, RMAX is the maximum factor by which h will be increased when a 
step length change is next considered, and h mu] and h max are user-supplied minimum and maximum absolute 
values of the step length to be attempted on any step. Finally, RDOWN, RSAME and RUP are factors by 
which h can be increased if the new method order is q - 1 , q (the current value) and q + 1 , respectively and 
R = max(RDOWN, RSAME, RUP). 

The two user-supplied routines used by the integrator are DIFFUN, which computes the derivatives, and 
PEDERV, which computes the Jacobian matrix. The structure of DIFFUN is given in figure 9. 1 . Flowcharts 
for DIFFUN and PEDERV are presented in figures 9.8 and 9.9, respectively. In these figures p and V are 
the mixture density and velocity. To maintain accuracy of the Jacobian matrix and prevent overflow errors 

PEDERV checks for species with zero concentrations and includes special calculation procedures for such a 
situation. 


Sensitivity Analysis 

For any static reaction problem the first-order sensitivity coefficients {S- (= dY/dm)} can be computed. 
Here Yj is the numerical solution for the ith (i = 1,...,N) dependent variable and rv is either an initial 
condition value or a rate coefficient parameter, that is, Aj, n J( E:, or Cj (see eqs. (8.3) and (8.4)). The sensitivity 
analysis computations use the decoupled direct method (refs. 30, 32 and 33), as implemented by Dunker (ref. 

34) and modified by Radhaknshnan (ref. 33) for nonisothermal combustion kinetics problems. An important 
feature of LSENS is that it can be used to generate any number of sensitivity coefficients, from just one initial 
condition or one rate coefficient parameter of one reaction to the full set of all N initial conditions and all 
3*NR rate coefficient parameters, where NR is the total number of reactions. Finally, the linear sensitivity 
coefficients of the temporal derivatives of the dependent variables, that is, {cY/dm}, may also be computed. 

This section reads, processes and checks the validity of all input data, solves for the sensitivity coefficients, 
and normalizes and prints them, when output is required. If pressure sensitivity coefficients are required this 
section computes, normalizes and prints them. Provision is made for the user to specify a cutoff level, TINY 
for the normalized sensitivity coefficients. Any normalized sensitivity coefficient that is smaller in magnitude 
than TINY is set equal to zero. For rate coefficient parameters an option to tabulate and print nonzero 
normalized sensitivity coefficients in decreasing magnitude is provided. The list is produced for each dependent 
variable. Above each normalized sensitivity coefficient the corresponding reaction number is placed. Thus, the 
user has the convenient option of obtaining a list of reaction numbers in order of decreasing importance for each 
variable. Finally, if required, this section computes, normalizes, prints and, if necessary, tabulates in order of 
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Figure 9.7— Flowchart of subroutine STODE, as used by LSENS (from reference 22). 
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Figure 9.8.— Flowchart of subroutine DIFFUN. 













Figure 9.9. — Flowchart of subroutine PEDERV. 
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decreasing importance, the sensitivity coefficients of the temporal derivatives of the variables. 


The 12 subroutines that comprise this section are SENDDM, DFDP, DMACHK, DMINIT, DMINTR, 
DMPJAC, DMPRNT, DMSTOD, SENSIN, SNSOUT, SNSPSC, and SNSTAB. Among these, six routines 
(SENDDM, DMACHK, DMINIT, DMPJAC, DMPRNT, and DMSTOD) were adapted from the May, 1984 
version of the code CHEMDDM (ref. 34). Other subprograms that are required for sensitivity analysis include 
DIFFUN, PEDERV, DAXPY, DDOT, DGEFA, DGESL, DSCAL, IDAMAX, SOLSY, XERRWV, and those 
used by DIFFUN. 

Besides reading, processing and checking the legality of all input, SENSIN sets the number of ODEs to be 
solved. In addition to the ODEs for nonconstant quantities, SENSIN examines the initial condition parameters 
with respect to which sensitivities are required. For example, if sensitivity coefficients with respect to the initial 
temperature are required, the Jacobian matrix elements of all variables with respect to the temperature must be 
computed. Therefore, even if the temperature is constant the routine includes it in the ODE list. Similar 
remarks apply to the density and inert species concentrations. 

The main subprogram in this section is SENDDM, whose structure and flowchart are given in figures 9. 1 
and 9.10, respectively. The internally-defined integer variable ICALL in figure 9.10 denotes if the call to 
SENDDM is the first one for the problem or a continuation. This routine sets the sensitivity arrays at the initial 
time and calls DMACHK, which checks that sufficient storage has been allocated for the problem. SENDDM 
also manages the call to LSODE. LSENS includes an option that dictates how the integration is to be continued 
after every printout of the solution: either normally, so that LSODE uses past solution values in further 
developing the solution, or reinitialize LSODE, so it effectively solves a new problem after every printout. If 
the second option is selected, SENDDM calls DMINIT to initialize the sensitivity arrays and sets the appropriate 
index that causes LSODE to reinitialize the integration process. 

The routine DMSTOD advances the sensitivity arrays by one step. The integration method used to solve 
for the sensitivities is the backward differentiation formula, as implemented in LSODE. Predicted values are 
first generated by using the Taylor series expansion method devised by Nordsieck (ref. 24). They are then 
corrected with the backward differentiation formula in conjunction with a single Newton-Raphson iteration using 
an analytical Jacobian matrix. At each step DMSTOD uses exactly the same step size and method order as 
those used by STODE to integrate the model problem. As for the model problem, the solution history for 
sensitivity coefficients is maintained in the Nordsieck history array. Thus, for the jth parameter, q , the 
Nx(q+1) matrix Zj n contains Sj n and its q scaled derivatives at £ n . ' 

The structure of DMSTOD is shown in figure 9.1 1, where the dashed lines connect subroutines included 
in, or required by, the LSODE package and the names in brackets are dummy procedure names. This figure 
shows that the only additional subprogram needed by the decoupled direct method to compute sensitivity 
coefficients is DFDP. DMPJAC is a simplified version of PREPJ (table 9.1). The former routine assumes that 
a specific iteration method (Newton-Raphson with a user-supplied analytical Jacobian matrix) is used; the latter 
is more generalized. DMPJAC can be replaced with PREPJ; however, to do so would reduce the efficiency 
marginally. DMINTR is based on INTDY (table 9.1) and computes the sensitivities and their derivatives at the 
output stations. 

The flowchart of DMSTOD is presented in figure 9.12, which illustrates how the Nordsieck history 
matrices for the sensitivity coefficients are advanced over the step K n -i.5j- In this figure Z is the 
predicted history matrix for the jth parameter at £ n , P is given by equation (9.3) and the vector 7 ^ n _j(l) 
contains the scaled first-derivative of n „, (i.e., hSj n _,). LSENS contains an option which control’s how often 


50 



Set ISTATE=1 


(1CALL=1) 


Is this N 
first call 
to 

SENDDM?. 


(ICALL=2) No 


Sensitivity 

analysis 

required? 


/ Does \ 
integration 
have to be 
restarted on 
each call to 
\SEUQQms 


Set 1ST ATE =1 


Call DMACHK to 
check that enough 
storage has been 
allocated 


Initialize sensitivity 
coefficient and 
first column of 
sensitivity history 
matrices with 
respect to all 
parameters 


Call LSODE to solve 
ODE's either over a 
specified integration 
interval or for a 
prescribed number 
of steps 


Sensitivity 

analysis 

required? 


Call DMINIT to 
initialize first 
column of all 
sensitivity history 
matrices at TOUT, 
if output required 
at print stations 


Figure 9.10. — Flowchart of subroutine SENDDM. 
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Figure 9.1 1 . — Structure of subroutine DMSTOD. 
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Figure 9.1 2. — Flowchart of subroutine DMSTOD. 
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the Jacobian matrix is updated when solving for the sensitivity coefficients: either on every step, or only on 
those steps for which STODE performed this update for the model problem. 


Chemical Equilibrium Computations 

The code has built-in procedures for computing the equilibrium composition for the following four 
assigned states: (1) pressure and temperature, (2) pressure and mixture mass-specific enthalpy, (3) specific 
volume and temperature, and (4) specific volume and mixture mass-specific internal energy. For cases 2 and 4 
the equilibrium temperature is also determined. The code automatically performs the appropriate type of 
equilibrium calculation, as discussed below. 

The main subprogram in this section is COMB, which manages the equilibrium computation, calls for 
output of results and prints the computational work required. The other routines used in this section whose 
structure is given in figure 9.13, are ELEMNT, EQLBRM, GAUSS, MATRIX, SECCPU, SPOUT and THRM 
COMB examines the variable TCONST (which is set in KINP and indicates if the kinetics problem following 
the equilibrium calculation is at constant temperature) and sets the appropriate switch, TP or HP, to indicate to 
EQLBRM whether or not an assigned temperature equilibrium computation is required. It also initializes the 
estimates for the equilibrium mixture composition and, if necessary, the equilibrium temperature. 

The equilibrium computations are performed in EQLBRM, which was adapted from the code CET 
(ref. 1 1). The routine selects the equilibrium problem type by examining the switches HP, TP and RHOCON 
which indicates if a constant-density kinetics problem follows the equilibrium computation. The equilibrium ’ 
state is obtained by minimizing either the Gibbs or Helmholtz function. The resulting algebraic equations are 
solved by using a descent Newton-Raphson iteration method (refs. 10 and 11), which automatically limits the 
size of the corrections at each iteration to avoid convergence difficulties. Also, to prevent negative 
concentrations and temperature the code solves for the logarithm of the variables. A flowchart of the calcula- 
tion procedure is given in figure 9.14, where v, T and p are, respectively, the mixture mass-specific volume 
temperature and pressure. ’ 


Incident Shock Computations 


LSENS includes an option to compute the thermodynamic state and velocity behind an incident shock. 

Two types of computations are performed. First, the code solves for the “equilibrium” shock conditions, that is, 
after the shock initiated reactions have equilibrated. The second calculation produces the “frozen” shock 
conditions immediately after shock passage, when the composition is unchanged from its initial value. 


The main subprogram in this section is SHOK, which manages the shock computation, calls for output of 
results and prints the computational work required. It also sets the type of shock computation, equilibrium or 
rozen, to be performed. Figure 9.15 gives the structure of this section, which uses the routines ELEMNT 
EQLBRM, SECCPU, SHOCKS , SPOUT, THRM, and those called by EQLBRM. 


The routine SHOCKS, which was adapted from CET (ref. 1 1), sets initial estimates for both post-shock 
conditions. It also computes both states by solving the mass, momentum and energy conservation equations A 
Newton-Raphson iteration procedure, which automatically limits the size of the corrections to minimize 
convergence difficulties, is used. To avoid negative variables during the solution procedure the equations are 
cast in terms of the logarithm of the variables. Figure 9.16 presents the flowchart of SHOCKS. In this figure 
the internally-defined logical variable EQL is used to denote the type of shock calculation and is a 
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Figure 9.13. — Structure of chemical equilibrium section. 
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Figure 9.14. Flowchart of equilibrium calculation procedure (subroutine EQLBRM). 

















Figure 9.15. — Structure of incident shock section- 
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Figure 9.16. Flowchart of incident shock calculation procedure (subroutine SHOCKS). 


















characteristic shock tube reaction length, required for the post-shock kinetics problem (see below). After the 
frozen shock conditions are successfully computed L in is calculated by SPOUT, if the user has not provided a 
value for it. 

Post-Shock Kinetics Problem . - Starting with the frozen shock state, the code follows the progress of the 
chemical reaction in the shocked gas by integrating the ODEs describing one-dimensional flow with assigned 
area over a prescribed time or distance interval. The flow area profile is given by a special function, which 
corrects for frictional losses (refs. 35 to 37): 


A(x) = 1 

A S 1 - (x/L m ) n 


(9.4) 


In this equation A(x) is the area at distance x, A s is the shock tube cross-sectional area, L m is a characteristic 
length, and the exponent r| is either 0.5 for a laminar boundary layer or 0.8 for a turbulent boundary layer. 

The length L m also depends on whether the boundary layer is laminar or turbulent. It may be specified by 
the user or is computed by the code as follows (refs. 36 and 37): 
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(9.5) 


In this equation d H (= where L p is the shock tube perimeter) is the shock tube hydraulic diameter, p is a 

boundary layer thickness parameter, M (= V/c, where c is the sonic velocity) is the Mach number, and p ST is a 
standard pressure, usually one atmosphere. The subscripts u l” and “2” refer, respectively, to conditions 
upstream and downstream of the shock, using a co-ordinate system attached to the shock, which is therefore 
stationary. Thus, the unshocked gas flows into the shock at velocity and the shocked gas flows away from it 
at veloctiy V 2 - Finally, the subscript U ST” denotes standard conditions and the quantity Pst^st^ST * s assume ^ 
to be the same as pjCj/p^ 


Perfectly Stirred Reactor Computations 

These computations can be performed for either a specified mass flow rate or a specified reactor 
temperature. In the former case, the code solves for the mixture composition and temperature at reactor exit. 
For the second problem type the mass flow rate and reactor exit mixture composition are computed. The 
problem type is identified by examining the user input parameters required for problem solution, so a separate 
switch need not be set. 

The main routine in this section, whose structure is shown in figure 9.17, is WSR. The other routines 
required by this section are DIFFUN, ELEMNT, EQLBRM, GAUSS, HETRAN, OUT2, PEDERV, RKTOUT, 
SECCPU, THRM, and WSOUT. The flowchart of WSR is given in figure 9.18, where m, T and x f are the 
mass flow rate, temperature and residence time, respectively. Also, rriQ is the mass flow rate either specified 
for the first solution of an assigned mass flow rate problem or to start the iteration for an assigned temperature 
problem and T 0 is the prescribed temperature for the first solution of an assigned temperature problem. 
Finally, T eq is the equilibrium temperature for the reactor inlet state. 
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Figure 9.17. — Structure of perfectly stirred reactor section. 
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Figure 9.18. — Flowchart of perfectly stirred reactor calculation procedure (subroutine WSR) 

















For both problem types WSR solves the governing nonlinear algebraic equations by using a Newton-Raph- 
son iteration technique, which automatically limits the size of the corrections to reduce convergence difficulties 
Also, to avoid negative results the code solves for the logarithm of the variables. Starting with conditions close 
to the equilibrium state a series of perfectly stirred reactor computations is performed until the desired mass 
flow rate or reactor temperature is reached. This technique is used to minimize the possibility of convergence 
to a false solution, that is, one that is mathematically correct but physically unrealistic. The routine includes 
several tests and, when necessary, restarts of the calculation to ensure that the solution is physically meaningful. 
Finally, it includes tests for possible blow-out of the chemical reaction within the reactor. 


Error Messages 

The code contains many error messages— too numerous to list here. Every input parameter is tested for 
legality and consistency with the other input variables. If an illegal input parameter is discovered, a detailed 
message is printed. Each error message is self-explanatory and complete. It not only describes the mistake but 
also tells the user how to fix the problem. During execution some tests are made to ensure that variables are 
within either given or reasonable bounds. Any difficulty encountered during execution will result in an error 
exit. A message giving the reason for the termination and the name of the subprogram where the problem 

occurred will also be primed. If the computation stops prematurely the user should look for the error message 
near the end of the output file. ' 
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CHAPTER 10 - CODE IMPLEMENTATION 


The LSENS package may have to be modified to make it compatible with the user's computer system and 
computational requirements. The modifications are classified into two categories: (a) those that must be made 
before the present version of the code can be used and (b) those required to enhance the computational 
capabilities of the code. In this chapter we describe the type (a) revisions. We also discuss certain optional 
changes that may be made. We conclude the chapter with a list of parameters that place restrictions on the size 
of the problem that can be solved with the present version of the code. The code adjustments needed to alter 
the built-in values for these parameters, that is, type (b) modifications, are, however, described in appendix C. 


Computer Language 

The code is compatible with most FORTRAN 77 compilers. However, it contains detailed instructions on 
how to convert it to FORTRAN 66, as described in chapter 9. 


Suppressing Underflow Error Messages 

The MAIN subprogram includes a system call to suppress underflow error messages. The form of this call 
used in the present version of LSENS is 

CALL ERRSET (208, 256, -1,1,1) 

where ERRSET is a VS FORTRAN supported subroutine that enables the user to control execution when error 
conditions occur. The number 208 is an IBM-designated code for underflow. On other systems, the call may 
have to be changed or deleted. For example, the following 

CALL ERRSET (74, .TRUE., .FALSE., .FALSE., .FALSE.) 

is appropriate for VAX computers. 


Function SECCPU 

The function SECCPU, which computes the incremental central processing unit (CPU) time in seconds (see 
table 9.1), may have to be replaced. This function calls the system clock and is given for several common 
computing systems in appendix B. 


Modifying Subroutine XERRWV 

The routine XERRWV, which prints out error messages from the LSODE package and the sensitivity 
routines DMACHK, DMINTR and DMSTOD (see table 9.1), is machine- and language-dependent. So the data 
type declaration for the argument MSG, which is a Hollerith literal or integer array containing the message to be 
printed, may have to be changed, as described in reference 22. However the routine itself gives the necessary 
modifications for several different machine environments. 
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BLOCK DATA Variables 


The next modification concerns the values assigned to the variables SMEST, TESTNO, THCX(3), and 
THDCX(l) in the BLOCK DATA module. The double-precision variable SMEST (current value = 1 OD-35) is 
^' n "° rmaliZing sensitivit y efficients. Any dependent variable, Y that is smaller in magnitude than ‘ 
SMEST is set equal to SMEST to avoid computational difficulties caused by an excessively small (or zero) Y 
The real variable TESTNO (current value = -1.0E35), which is essentially is the value used to initialize 
several variables, such as the print stations, that is, distinct points at which the solution is required. Either one 
o or both SMEST and TESTNO may be changed by the user. The double-precision variables THCX(3) (= 2/3) 
and THDCX(l) (= 4/3) are used to compute certain thermodynamic properties, and may be changed to make 
them consistent with the precision of, that is, number of decimal digits considered by, the machine. 

L ogical Tape Unit Numbers. - All logical tape unit numbers for input and output are also set in the 
BLOCK DATA, and may be changed by the user. The tape numbers used for input are as follows. First, a 
data file containing thermodynamic data for the species must be made available on unit LTHM, whose current 
value is 4. Second, data for the user’s problem are read from unit LREAD, which is currently equal to 5. This 
data type includes the chemical reaction mechanism, keywords identifying the problem to be solved, initial 
conditions, etc. Thermodynamic data may also be included in this file, in which case they are copied on to a 
separate scratch file associated with the logical tape unit LSCR, whose present setting is 9. Subsequently, these 
coefficients are read from unit LSCR. All other data are copied on to, and later read from, a separate scratch 
file, which must be made available on the logical tape unit LDAT, which is currently 7. Finally, if transport 

properties are required for the problem the necessary data are read from the logical tape unit LTRAP (current 
value = 8). 

All output information, except that given below, is directed to the logical tape unit number LWRITE, whose 
current value is 6. Summary information regarding storage and work requirements for sensitivity analysis from 
the routine DMPRNT and all error messages from the routine XERRWV are sent to the logical tape unit 
number LUNTT, which is also currently equal to 6. 


Reducing Storage Requirement 


The final code modification concerns computer memory requirement. If the sensitivity analysis option is 
not required and computer storage is of concern to the user, the lengths LRW and LIW of the real and integer 
work arrays RWORK and IWORK, respectively, may be decreased to the values indicated in the code. The 
dimensions of RWORK and IWORK must also be decreased to the values given in the code. To further reduce 
storage requirement, all sensitivity subroutines except SENDDM (see chapter 8) and the common blocks 

SENNAM, SENNOR, SENPAR, and SENSOL may be replaced with dummy versions or, if allowed by the 
loader, even eliminated. J 


The present version of the code makes no use of the routines RSCOM, SVCOM, XSETF, and XSETUN 
(see table 9.1), which may all be deleted if the user intends to use LSENS solely as a black box, which provides 
so utions to kinetics and sensitivity analysis problems. In addition, if the iteration techniques given by MITER 
= 4 and 5 (see table 9.5) will not be used, the routines DGBFA and DGBSL may be replaced with dummy 
routines or even eliminated, if allowed by the loader. Finally, if parameters related to problem size are smaller 
than the built-in values (see below), the modifications described in appendix C may be made to decrease the 
storage requirement. 
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Code Limitations 


The present version of LSENS allows for a maximum number of 50 (reacting-plus-inert) species 
participating in a maximum number of 250 reactions, of which up to 35 may be of the third-body collisional 
type. A chemical species may contain as many as 15 different elements (atoms, etc.). For any general third- 
body reaction, third-body collisional efficiencies different from unity can be specified for a maximum number of 
10 species. As described in chapter 1 1, one or more of the three quantities, pressure, area and temperature, can 
be specified for the complete problem by means of a table of values. If this option is used up to 100 values can 
be given. Finally, the maximum number of print stations is 100. 
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CHAPTER I 1 - INPUT DATA DESCRIPTION AND PREPARATION 


Two input data files are normally required to execute the code. The first one, which we refer to as the 
Standard Thermodynamic Data File”, must contain the chemical symbol and composition, molar mass and 
thermodynamic data for each species. The second file, which we call the “Problem Data File”, must give 
information about, and data required by, the problem(s) to be solved. If desired, the user may include in this 
data file thermodynamic data for any species. A third input file, containing transport property data, is required 
for certain computations. This file will be referred to as the “Transport Properties Data File”. 

We now give a description and guide to the preparation of the input data files. In particular, we first 
discuss the thermodynamic and transport properties data information that must be supplied. We then describe 
the preparation of the Problem Data File for a single case. Finally, the construction of the data file required to 
solve multiple problems in a single run is explained. 


Thermodynamic Data Information 

The thermodynamic data for the species may be supplied via the Standard Thermodynamic Data File 
and/or the Problem Data File. The user informs the code where to get the thermodynamic data by means of the 
keyword TAPE or CARD in columns 1 to 4 of the first line of the Problem Data File. If data for all species are 
to be taken from the Standard Thermodynamic Data File the word TAPE must be used. A standard file, 
containing data from the most recent thermodynamic data base of the CET code (ref. 1 1) for many species in 
the C-H-N-O system, is supplied with LSENS. Table 11.1 shows the beginning of this file. The first line 
contains the three temperatures, TLOW, TMID and THIGH, which together define two temperature ranges (300 
to 1000 K and 1000 to 5000 K in table 1 1.1) for two sets of the seven coefficients defined in equations (8.32) 
to (8.34). The format used to read this line is 3F10.3. For each species, the data are written in a group of four 
lines. For convenience, each line contains its number in column 80. The first line contains the following 
identification information: species name, thermodynamic data source and date when compiled, composition and 
phase of the species, temperature range over which the thermodynamic data are valid, and the molar mass of the 
species. The format used to read this line is A8, 16X, 4(A2, F3.0), 21X, E13.6. On the next three lines, 
coefficients for the high temperature range, followed by those for the low temperature range, are listed. The 
format used to read these lines is 5E15.8, /, 5E15.8, /, 4E15.8. For some species the fourth line contains a fifth 
number, which is the heat of formation at 25 °C divided by the universal gas constant and has the units of 
Kelvin. The end of the standard file is indicated by a line containing the word END in columns I to 3. 

If thermodynamic data for some (or all) species are to be selected from the Problem Data File the keyword 
CARD should be used. The thermodynamic data must then be placed immediately after the first line. The 
format for this information is identical to that of the Standard Thermodynamic Data File. That is, the second 
line of the Problem Data File must contain the three temperatures, TLOW, TMID and THIGH. Next, 
thermodynamic data must be given for all species for which the user wishes to provide this information in the 
Problem Data File. For each such species, irrespective of the case(s) in which it appears, the four lines of data 
described above must be supplied. Finally, the end of the thermodynamic data is indicated by a line containing 
the word END in columns 1 to 3. If data are given for any species in both the Standard Thermodynamic Data 
File and the Problem Data File, the latter information will be used and the former ignored. Thus, the user has a 
convenient way of temporarily changing any thermodynamic data or adding new species without modifying the 
Standard File. 

The above material, that is, either the keyword TAPE or the keyword CARD followed by the required data, 
is given only once, at the beginning of the Problem Data File, irrespective of the number of problems contained 
therein. Therefore, if any thermodynamic data are to be included in this file, they should be placed here. 



TABLE 11.1. 


ILLUSTRATION OF STRUCTURE OF STANDARD THERMODYNAMIC DATA FILE 


300.000 1000.000 5000.000 

AR L 5/6 6 AR 1.00 0.00 0.00 0.G 300.000 5000.000 39.94800 1 

0 . 25000000E 01 0.00000000 0.00000000 0.00000000 0.00000000 2 

0 .7453750 2E 03 0.43660006E 01 0.25000000E 01 0.00000000 0.00000000 3 

0.00000000 0 . 00000000 - 0 .74537498E 03 0.43660006E 01 0.00000000 4 

BR J 6/74BR 1. 0. 0. 0.G 300.000 5000.000 79.909 1 

0 . 20843 207E 01 0 . 7 19 49 4 83E - 03 - 0 . 27 4 199 24E - 06 0 . 424 22 65 0E - 1 0 - 0 . 2 37 9 1 57 0E - 14 2 

0 . 12858837E 05 0.90838003E 01 0.24611551E 01 0 . 3331927 5E -03 - 0 . 10080655E- 05 3 

0.12262126E-08-0 . 44283 510E- 12 0.12711920E 05 0.69494733E 01 4 

BR2 J12/61BR 2.0 0.0 0.0 O.G 300.000 5000.000 159.818 1 

0 . 4447 949 5E 01 0 . 100 51208E - 03 - 0 . 16 3 9 3 816E - 07 0 . 22685621E -11 -0 . 10236774E- 15 2 

0.236 5994 IE 04 0.40888431E 01 0.38469580E 01 0 . 26111841E-02 - 0 .40034147E- 05 3 

0.28120689E-08-0 .7 3256202E- 12 0.24846984E 04 0.69696985E 01 4 

C J 3/78C 1. 0. 0. O.G 300.000 5000.000 12.01100 1 

0 . 257 69424E 01 - 0 . 13 9 03 944E - 03 0 . 69 4 81807 E - 07 - 0 . 67 4 14 021E - 11 - 0 . 4 3 3 890 04E - 16 2 

0 . 85425220E 05 0.43358122E 01 0.25279476E 0 1 - 0 . 12 519 4 OOE - 03 0 . 22 54449 6E - 06 3 

- 0 . 18489 024E - 09 0 . 57 29 17 4 IE - 13 0.85448374E 05 0.46274790E 01 0.00000000 4 

CH J12/67C l.H 1.0 0.0 O.G 300.000 5000.000 13.01890 1 

0.22673116E 01 0 . 22043 000E- 02 - 0 . 62250191E - 06 0 . 69 6 89 94 OE - 1 0 - 0 . 2 12749 52E - 14 2 

0 . 7 0 83 8 037 E 05 0.87889352E 01 0.35632752E 0 1 - 0 . 20 03 1 37 2E - 03 - 0 . 4 0129 814E - 06 3 

0 . 18226922E -08 -0 . 867 68311E- 12 0.70405506E 05 0.17628023E 01 0.00000000 4 

CH2 J12/72C l.H 2. 0. O.G 300.000 5000.000 14.02680 1 

0 . 27 52 547 9E 01 0 . 3 97 82047 E - 02 - 0 . 149 2 17 31E - 0 5 0 . 25956899E-09 -0 . 17110673E- 13 2 

0 . 4 5 5477 59E 05 0.66534799E 01 0.35883347E 01 0 . 217 24137E -02 - 0 . 13323408E- 05 3 

0 . 1946944 5E -08 -0 . 89431394E- 12 0.45315188E 05 0.22627869E 01 0.00000000 4 

CH20 J 3/61C l.H 2.0 1.0 O.G 300.000 5000.000 30.02620 1 

0.28364249E 01 0 . 6 860529 8E - 02 - 0 . 26 882647 E - 0 5 0 . 47 97 1258E - 09 - 0 . 3 21184 06E - 13 2 

- 0 . 1523603 IE 05 0.78531169E 01 0.37963783E 0 1 - 0 . 257 0 17 8 5E - 02 0 . 1 854 881 5E - 04 3 

- 0 . 17 869177E - 07 0 . 5 55 044 51E - 11 - 0 . 1 50 88947 E 05 0.47548163E 01 0.00000000 4 

CH202 L 5/80C l.H 2,0 2. O.G 300.000 5000.000 46.02559 1 

0 . 57 87 877 IE 01 0 . 7 553 9 9 09 E - 0 2 - 0 . 3 0 99 5161E - 0 5 0 . 54494809E - 09 - 0 . 347 04210E - 13 2 

-0.48 19 123 OE 0 5 - 0 . 6 52 99 0 15E 01 0.21183796E 01 0 . 11 17 54 69E - 0 1 0 . 2 627 077 3E - 0 5 3 

-0.81816403E-08 0 . 30133404E- 11 - 0 . 46669293E 05 0.14480175E 02 0.00000000 4 

CH3 J 6/69 C l.H 3.0 0.0 O.G 300.000 5000.000 15.03470 1 

0 . 28400327E 01 0 . 6 0869 086E - 02 - 0 . 217 4 03 3 8E - 0 5 0 . 3 604 2 57 6E - 09 - 0 . 2 27 253 OOE - 13 2 

0 . 16449 813E 05 0.55056751E 01 0.34666350E 01 0 . 3 83 0 184 5E - 0 2 0 . 1 0116 80 2E - 0 5 3 

-0.188 59 236E-08 0 . 6 6 803 1 82E - 12 0.16313104E 05 0.24172192E 01 0.00000000 4 

CH20H BUR 84C l.H 3.0 1. O.G 300.000 5000.000 31.03410 1 

0 . 46129 88 5E 01 0 . 6 297 1413 E - 02 - 0 . 20 0294 83E - 0 5 0 . 27 889868E -09 -0 . 13731448E- 13 2 

- 0 . 38908596E 04 0.52852684E 00 0.33168221E 01 0 . 66920184E - 02 0 . 2 8148397 E - 05 3 

-0.57237202E-08 0 . 2 07 24 0 56E - 11 - 0 . 3 3 14 63 2 IE 04 0.81576948E 01 -0 . 20128906E 04 4 

CH30 L 6/80C l.H 3.0 1. O.G 300.000 5000.000 31.03410 1 

0 . 37 59 077 IE 01 0 . 7 894 5 04 8E - 02 - 0 . 267 104 86E - 0 5 0 . 39814 507E -09 - 0 . 21447 125E- 13 2 

0 . 13 208081E 03 0.29936295E 01 0.21097078E 01 0 . 7 19 277 56E - 0 2 0 . 53939157E- 05 3 

-0.74311082E-08 0 . 2 09 3 9 57 8E - 11 0.97822803E 03 0.13137219E 02 0.00000000 4 

CH4 L 5/84C l.H 4. 0. O.G 300.000 5000.000 16.04260 1 

0.21737833E 01 0 . 899 3 6 59 2E - 02 - 0 . 27 85 54 67 E - 0 5 0 . 397 7 5117E - 09 - 0 . 1997 642 5E - 13 2 

- 0 . 10216566E 05 0.70773563E 01 0.29428148E 01 0 . 2 51537 2 8E - 02 0 .7 9 08583 9E - 05 3 

-0.47495483E-08 0 . 14244 9 10E - 12 - 0 . 10056824E 05 0.45714579E 0 1 - 0 . 9 00 51 69 IE 04 4 

CH30H L 4/80C l.H 4.0 1. O.G 300.000 5000.000 32.04200 1 

0.403 347 3 OE 01 0 . 9 3 6 80 508E - 02 - 0 . 3 044937 3E - 0 5 0 . 43456994E - 09 - 0 . 22136329E- 13 2 

- 0 . 261 59 859E 05 0.23539820E 01 0.26587849E 01 0 . 7 3 51 5 214E - 02 0 .7 1443337 E- 05 3 

-0.87661114E-08 0 . 23805116E - 11 - 0 . 253 53684E 05 0.11238121E 02 0.00000000 4 

CN J 6/69C l.N 1.0 0.0 O.G 300.000 5000.000 26.01770 1 

0 . 3603628 5E 01 0 . 3 3644 390E- 03 0 . 1 0 02 89 33 E - 0 6 - 0 . 16 3 1816 6E - 10 - 0 . 3 62 867 22E - 15 2 

0 . 51159 83 3E 05 0.35454505E 01 0.37386307E 01 - 0 . 1923 9 224E - 02 0 . 47 0 3 5189 E - 0 5 3 

-0 . 31113000E-08 0 . 61675318E-12 0.51270927E 05 0.34490218E 01 0.00000000 4 

CNN J 6/66C l.N 2.00 0.00 O.G 300.000 5000.000 40.02440 1 

0 . 48209077E 01 0 . 247 9 0 014E - 02 - 0 . 94 64 4109E - 0 6 0 . 165487 64E -09 -0 . 10899129E- 13 2 

0 . 6 868594 8E 0 5 - 0 . 484 84 039 E 00 0.35077779E 01 0 .72023958E-02 - 0 .7 5574589E- 05 3 

0.42979217E-08-0.94257935E-12 0.68994281E 05 0.60234964E 01 0.00000000 4 

END 
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regardless of the case(s) they are intended for. Thus, the same thermodynamic data, that is, those given in the 
Standard Thermodynamic Data File and/or the Problem Data File, will be used for all problems. 


Transport Properties Data 

This information is required only if heat transfer rates are to be computed using the built-in heat transfer 
correlations (see eqs. (8.24) and (8.29)). It must be supplied in a separate file and cannot be included in the 
Problem Data File. A Transport Properties Data File is provided with the code. This file contains coefficients for 
curve-fitted equations giving viscosity (in g/(cm-s)xltf>) and thermal conductivity (in cal/(cm-s-K)* 10^ as a 
function of temperature for 19 species (see eqs. (8.37) and (8.38)) and is listed in table 1 1.2. Each line contains 
data for one species and one transport property in the following order: species name, the four coefficents and 
the transport property. The format for reading each line is (IX, A8, 4X, 4E15.6, 3X, A4). The end of the file is 
indicated by a line containing the word LAST in columns I to 4. 


H2 

H2 

CH30H 

CH30H 

CH4 

CH4 

C2H2 

C2H2 

C2H4 

C2H4 

C3H8 

C3H8 

C6H6 

C6H6 

NO 

NO 

N2 

N2 

AR 

AR 

O 

O 

H 

H 

H20 
H20 
NH3 
NH3 
N02 
NO 2 
OH 
OH 
CO 
CO 
C02 
C02 
02 
02 

LAST 


TABLE 11.2. - TRANSPORT PROPERTIES DATA FILE SUPPLIED WITH LSENS 


0 

•687200E 

00 

0 

. 116129E 

01 

0 

. 641455E 

00 

0 

. 7 9 37 9 2E 

00 

0 

. 600440E 

00 

0 

. 853201E 

00 

0 

. 579032E 

00 

0 

. 666734E 

00 

0 

. 578808E 

00 

0 

. 674458E 

00 

0 

. 578645E 

00 

0 

. 638223E 

00 

0 

. 611472E 

00 

0 

. 549565E 

00 

0 

. 646504E 

00 
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Problem Data File for Single Case 


Following either the keyword TAPE or the end of the thermodynamic data, the Problem Data File must 
contain information required to execute the first (or only) case. The various types of input data needed to 
execute a single case, in the order that they must be placed after the thermodynamic data information, are as 
follows: 


1. Title Line 

2. Chemical Reactions and Collisional Efficiencies 

3. Inert Species List 

4. Integration and Assigned Variables, Units and Fuel Name Line 

5. Problem Data, Related Options, Heat Transfer Data, and Output Controls (Namelist PROB) 

6. Assigned Temperature Profile (Namelist TMPDAT) (optional) 

7. Perfectly Stirred Reactor Problem Data (Namelist WSPROB) (optional) 

8. Initial Conditions (and Namelist START) 

9. Local Error Tolerances and Other Integration Controls (Namelist SOLVER) 

10. Sensitivity Analysis Data (and namelist SENRXN) (optional) 

1 1. FINIS Line 

For each item listed above, we describe the variables that have to be set and, where appropriate, give both 
the values to be assigned and the default values. Figure 11.1 gives a flow diagram of the necessary input, 
including the available options. 

(1) Title Line 

The first line after the thermodynamic data information is a title message, of maximum length 80 
characters. This input line, read with the format 20A4, is provided as a convenient means of identifying the 
problem. If a title is not needed a blank line must be inserted here. 

(21 Chemical Reactions and Collisional Efficiencies 

For all problems the user must provide the chemical reaction mechanism and rate coefficient data. The 
mechanism may contain up to a maximum of 250 reactions involving up to 50 species. Any collisional 
reaction, including the spontaneous activation or deactivation of excited-state species, can be used. However, a 
maximum of only two different reactant and two different product species may be specified for a reaction. 
Therefore the following types of reaction are allowed: 


Vi'S, + v 2 'S 2 - v 3 "S 3 + v 4 "S 4 , 

(11.1) 

v 2 'S 2 v 3 "S 3 + v 4 "S 4 , 

(11.2) 

V 1 ^1 + v 2$2 ** v 3 ^3’ 

(11.3) 

v 2 'S 2 ** v 3 "S 3 , 

(11.4) 

M + Vj'Sj + v 2 'S 2 ** v 3 "S 3 + M, 

(11.5) 

M + v 2 >S 2 ~ v 3" 5 3 + V 4" S 4 + M ’ 

(11.6) 

M + v 2 'S 2 ~ v 3 "S 3 + M, 

(11.7) 

hv + v 2 '5’ 2 ► v 3 S 3 + v 4 S 4 . 

(11.8) 


69 


^ Thermodynamic data information ^ 

* 


— — L 

^ Case title ^ 

i 

— ♦ zf 


Chemical reactions 
Rate coefficient parameters 
Third-body collisionai efficiencies 


Bimolecular shuffle 

Uni molecular decomposition/two-body recombination 
Two-body dissociation/three-body recombination 
Spontaneous activation/deactivation 
Photochemical decompostion 
irreversible reaction 


X 


c 


Inert species list 


3 


^Integration variable^ ^Assigned variable^ 


Distance Pressure 

Time Area 

! 

^ . S 

cq* cgs 

U S. Customary U.S. Customary 

SI SI 

— f 1 


Shock 


Constant area 
Assigned area 
Rocket performance 
option 


c 


Problem type and options 


> 


Constant pressure 
Assigned pressure 
Constant temperature 
Assigned temperature 


Flow 

reaction 


Static 

reaction 


Perfectly 
stirred reactor 


Heat 

transfer 


Constant density 
Sensitivity analysis 


Print options 


Assigned variable profile options 
Equilibrium calculation option 


Heat transfer options 


x 


^ Temperature profile options ^ 


^ Perfectly stirred reactor problem type and options ^ 


Simplified composition 
input option: fuel -oxidant 
equivalence ratio or 
fuel -oxidant mass ratio 


C 


Initial conditions 


> 




Initial mixture mole or mass fractions 


Thermodynamic and 
fluid dynamic 
properties 


x 


C 


Integration controls 


3 


Initial 

/■ \ 

conditions 

Sensitivity analysis V 


Dependent 

variables 


Reaction numbers) 
and rate coefficient 
parameters) 


C 


FINIS line 


D 


Figure 11.1 —Structure of Problem Data File for single (or first) case. 
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In these equations Vj' is the stoichiometric coefficient (i.e., number of moles) of reactant species i in the 
reaction, v* is the stoichiometric coefficient of product species i in the reaction, S j is the chemical symbol of 
species i, the species M represents a general third-body collision partner, and the quantity hv represents a single 
quantum of radiation. The single arrow in equation (1 1.8) indicates that the photochemical reaction is 
irreversible. The double arrows in the other reactions, equations (1 1.1) to (1 1.7), mean that they can be either 
reversible or irreversible. 

Following the title line, the chemical reactions must be listed, one per line. The line has fields for the 
stoichiometric coefficients and names of two reactant and two product species. A general third body species is 
denoted by the symbol W M” and a quantum of radiation by “HNU”. The symbol for the species electron is “E” 
in the Standard Thermodynamic Data File supplied with LSENS. The reaction line also has fields for indicating 
a reversible or irreversible reaction and the special rate coefficient expression, equation (8.4). Values for the 
rate coefficient parameters Aj, rij and either Ej or Cj (see eqs. (8.3) and (8.4)) must be specified here. These 
parameters must be given in cgs units, that is, mol, cm, s, and cal. The reactions may be placed in any order, 
regardless of type. The exact format of each reaction line is 2(F3.1, A8, IX), Al, 2(F3.1, A8, IX), Al, E10.4, 
2F10.4, as follows: 


Columns 

Variable 

type 

Format 

Content and explanation 

1-3 

Real 

F3.1 

Stoichiometric coefficient of first reactant, if two reactants are present; default 
value = 1.0 

4-11 

Character 

A8 

(a) Name of first reactant, if two reactants are present 

(b) Letter M in column 4 if a collisional decomposition reaction 

(c) HNU in columns 4 to 6 if a photochemical decomposition reaction 

13-15 

Real 

F3.1 

Stoichiometric coefficient of second reactant (only reactant if a decomposition 
reaction); default value =1.0 

16-23 

Character 

A8 

Name of second (or only) reactant 

25 

Character 

Al 

Equal to symbol (=) if reaction is reversible; any other symbol if it is irreversible 

26-28 

Real 

F3.1 

Stoichiometric coefficient of first product (only product if a recombination 
reaction); default value = 1.0 

29-36 

Character 

A8 

Name of first (or only) product 

38-40 

Real 

F3.1 

Stoichiometric coefficient of second product, if two products are present; default 
value = 1.0 

41-48 

Character 

A8 

(a) Name of second product, if two products are present 

(b) Letter M in column 41 if a collisional recombination reaction 

50 

Character 

Al 

Leave blank for equation (8.3); write *S" if equation (8.4) is used for kj 

51-60 

Double 

precision 

E10.4 

Aj for equation (8.3) or (8.4) 

61-70 

Double 

precision 

F10.4 

^ for equation (8.3) or (8.4) 

71-80 

Double 

precision 

FI 0.4 

Ej for equation (8.3) or Cj for equation (8.4) 
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If any stoichiometric coefficient is not listed, that is, the corresponding columns are left blank, a value of unitv 
will be used. 3 


If numerical instability or other difficulty occurs while processing the input data, the user should check the 
reaction mechanism, especially the three rate coefficient parameters, to ensure that every variable has been 
placed in its correct field. The image produced of the input data file (see chapter 12 for details) will assist the 
user perform this task. These checks should also be made if any problems such as excessive computational 
work or questionable results (e.g. exceedingly long or short induction delay or heat release time) occur. 

w react ' on tnechanism may contain up to 35 general third-body collisional reactions, that is, one with 
“M” as a reactant and/or product species. For any such reaction collisional efficiencies different from 1.0 may 
be specified for up to 10 species as follows. A line with the word THIRDBODY in columns 4 to 12 is placed 
immediately after the particular collisional reaction for which third-body efficiencies are to be considered. This 
line is followed by one or more lines, each containing names and collisional efficiencies of up to four species 
(for which the efficiencies are different from unity). The Aj factor for any reaction of this type is for a 
standard collisional partner, usually nitrogen or an inert gas, such as argon. The format used to read each line is 
4(A8, 2X, F10.3), corresponding to the following variables: 


Columns 

Variable 

type 

Format 

Content 

1-8 

Character 

A8 

Species name 

11-20 

Real 

FI 0.3 

Collisional efficiency value 

21-28 

Character 

A8 

Species name 

31-40 

Real 

FI 0.3 

Collisional efficiency value 

41-48 

Character 

A8 

Species name 

51-60 

Real 

FI 0.3 

Collisional efficiency value 

61-68 

Character 

A8 

Species name 

71-80 

Real 

FI 0.3 

Collisional efficiency value 


The end of the third-body collisional efficiency list is indicated by either a blank line or the word END in 
the first three columns of a species field. If exactly four species are listed on the last line, an additional line 
that either contains the word END in columns 1 to 3 or is blank must be added. 

The end of the reaction list is denoted by either a blank line or the word END in columns 4 to 7. 

(3) Inert Species List 

Following the reaction list, the names of any inert species, that is, species present but not reacting, must be 
gwen, eight per line, starting in columns 1, 11, 21, 31, 41, 51, 61 and 71. The format for each line is 8(A8, 
2X). The end of the inert species list is indicated by a species field that either is blank or contains the word 
END in the first three columns. If the last line in this list contains exactly eight species, the next line should 
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either be blank or have the word END in columns 1 to 3, as a more positive indicator of the end of the list. If 
no inert species is to be considered for the problem, the reaction list must be followed by a line that either 
contains the word END in columns 1 to 3 or is blank. 

(4) Integration and Assigned Variables, Units and Fuel Name Line 

The line following the inert species list specifies the independent variable for the problem and, as described 
below, the variable, if any, for which the user intends to assign a profile. This line also contains the input units, 
output units and, possibly, the fuel name. 

The independent variable for the ordinary differential equations describing reaction chemisty depends on 
the problem. This variable, which we refer to as the “integration variable”, can be either time or distance for 
any flow problem, including that following an incident shock or a perfectly stirred reactor computation. For a 
static problem, however, only time may be used. 

To solve a static reaction problem the user must provide either the pressure (p) or density (p) for the entire 
integration interval. Of the two, only pressure may be assigned as a function of time: that is, density can be 
prescribed only as constant. For a flow problem the solution for either pressure or area (A) must be supplied. 

In this case, either quantity may be described by a function of either time or distance. The variable (pressure or 
area) for which a non-constant profile can be given is called the “assigned variable”. Its name must be included 
on this line, even if it is specified as constant. If neither of the two variables is assigned (e.g. a constant density 
problem), the corresponding field must be blank. The same is true when the assigned variable is described by a 
built-in function (e.g., flow problem following an incident shock computation). 

Either the same or different units can be selected for input and output. Table 1 1.3 lists the input units for 
each of the three systems, that is, cgs, U.S. customary and SI, built into the code. 

The initial composition of the reacting mixture is usually specified by means of mole or mass fractions. 
However, for a general hydrocarbon fuel, the user has the option of specifying this information by the simple 
means of either the fuel-oxidant equivalence ratio or the fuel-oxidant mass ratio. If the user intends to use the 
simplified composition input option, the name of the fuel must be entered on this data line. The fuel name may 
be given even if this option is not used. 

The Integration and Assigned Variables, Units and Fuel Name line therefore contains only character vari- 
ables and its format is 4(A4, 6X), A8. The keywords and variable name that must be included here are given 
below, with the default option, if any, underlined: 
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Columns 

Content 

Explanation 

1-4 

TIME 

Time is the integration (i.e., independent) variable 

1-8 

DISTANCE 

Distance is the integration variable 

11-18 

PRESSURE 

Pressure profile is assigned 

11-14 

AREA 

Area profile is assigned 

(Leave blank for a constant density problem, a shock kinetics 
problem and a perfectly stirred reactor problem with no flow 
problem following it) 

21-23 

CGS 

Input in cgs (internal) units 

21-23 

FPS 

Input in U.S. Customary units 

21-22 

SI 

Input in SI units 

31-33 

CGS 

Output in cgs (internal) units 

31-33 

FPS 

Output in U.S. Customary units 

31-32 

SI 

Output in SI units 

41-48 

Fuel name 

Name of fuel, if the simplified composition input option will be 
used to specify the initial mixture composition 


If the fuel name is not required and default options are to be used for all other variables, this line may be blank. 


TABLE 11.3. - UNITS FOR INPUT VARIABLES IN THE THREE SYSTEMS 
ALLOWED BY THE CODE 


Variables 

Units 8 

cgs 

(internal) 

U.S 

customary 

SI 

Mass 

g 

lb 

kg 

Length 

cm 

ft 

m 

Time 

s 

s 

s 

Density 

g/cm 3 

lb/ft 3 

kg/m 3 

Pressure 5,0 

atm 

Ibf/ft 2 

N/m 2 

Area 0 

cm 2 

ft 2 

m 2 

Volume 

cm 3 

ft 3 

_3 

m 

Temperature 

K 

°R 

K 

Velocity 

cm/s 

ft/s 

m/s 

Mass flow rate 

g/s 

Ib/s 

kg/s 

Species 

Mole or mass 

Mole or mass 

Mole or mass 

concentration 

fraction 

fraction 

fraction 


Motivation energy must be in calories per mole, and the preexponential factor 
in cgs units. 

Pressure may also be specified in torr (millimeters of mercury) for all three 
systems. 

c For rocket performance calculations, the combustion chamber pressure and 
nozzle throat area must be given in psia and in 2 , respectively. 
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(5) Problem Data, Related Options, Heat Transfer Data, and Output Controls (Namelist PROB) 

Next, additional information regarding the problem to be solved is given in a namelist called PROB. It 
contains the logical variables that designate the problem type. The choices are regular static or flow kinetics, 
shock kinetics, perfectly stirred reactor (PSR) kinetics, and PSR-plus-plug flow reaction kinetics. The namelist 
also contains logical variables that select options for static and flow problems. The options related to problem 
type include constant pressure, constant density, constant temperature, assigned temperature, constant area, heat 
transfer, heat transfer model, equilibrium reaction, and sensitivity analysis. Pressure and area profiles are also 
specified in PROB. Other options related to the testing of kinetic mechanism legality and the type of output 
generated are selected in this namelist. Finally, printout information is generally given here. 

Because of the many different options built into the code PROB contains a large number of variables, 
which, together with their explanations, are listed in table 1 1.4. To assist the user prepare this namelist, that is, 
to decide what variables have to be set, we consider each problem type and option in a separate subsection. 

The user has to read only the subsection(s) relevant to the problem type and option(s) selected. 

Problem Types and Related Options . - We now describe how to select each problem type and, for static 
and flow kinetics problems, the related options, except heat transfer. 

Static problem . - For this problem type the calculation may be performed either at constant density or with 
a user-supplied pressure-versus-time profile. A constant density static problem is indicated by setting the logical 
variable RHOCON equal to TRUE. 

An assigned pressure static problem is selected by means of the keyword PRESSURE on the Integration 
and Assigned Variables, Units and Fuel Name line, as described in item 4. The pressure-versus-time (p-t) pro- 
file can be specified by using one of the following two methods: 

(1) A table of pressure as a function of time. 

(2) A polynomial function of up to third degree: 

p = CTO + CTl*t + CT2*^ + CT3*t 3 . (11.9) 

To use method (1) the pressure values must be set in the array ATB and corresponding time values in the 
array TTB. Method (2) is selected by giving nonzero values for one or more of the four constants CTO, CT 1 , 
CT2, and CT3. A constant pressure calculation can be performed by setting a nonzero value for only CTO (= the 
desired pressure). An alternative method of specifying a constant pressure problem is to set the logical variable 
PCON equal to TRUE. The pressure will then be held constant at its user-supplied initial value (see item 8, 
“Initial Conditions”). The combination of the switch PCON equal to TRUE and a nonzero value for (only) 

CTO can also be used. 

One-dimensional flow problem . - Either pressure or area may be assigned for a plug flow (i.e., no 
backmixing) reaction problem. An assigned pressure flow problem is selected by means of the keyword PRES- 
SURE on the Integration and Assigned Variables, Units and Fuel Name line, as described in item 4. The pres- 
sure can be given as a function of either time (t) or distance (x), independently of the choice of integration 
variable. One of the following two methods can be used to specify p: 
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TABLE IX .4 


DESCRIPTION OF NAMELIST PROB 


Variable 

name 

Variable 

type 

Value 

Explanation 

ACON 

Logical 

TRUE 

FALSE 

Area is assigned constant 
Area may vary for the problem 

APRINT 

Real 


Array of areas or pressures at which output is desired- 
maximum number of print stations =100 

ATB 

Real 

— 

Array of areas or pressures when specifying assigned 
variable in tabular form; maximum number of values = 100 

ATHROT 

Real 


Rocket nozzle throat area in square inches 

BETA 

Real 


?ir^ 8i 2 nless boundary layer Parameter; used to compute 
LSUBM for a shock kinetic case 

BORE 

Real 


Diameter of piston used for computing heat transfer 
coefficient when OTTO = TRUE; default value = 9 cm 

COMBUS 

Logical 

TRUE 

FALSE 

An equilibrium computation is to be performed 
Equilibrium computation is not required 

CONC 

Logical 

TRUE 

FALSE 

Concentrations to be printed out as moles per unit volume 
Concentrations to be printed out as mass fractions 

CTO 

CT1 

CT2 

CT3 

Real 


Coefficients in the assigned variable (AVAR) versus time 
<t) equation: 

AVAR * CTO ♦ CT1 *t + CT2*t 2 + CT3*t 3 

CXO 

CXI 

CX2 

CX3 

Real 


Coefficients in the assigned variable (AVAR) versus 
distance (x) equation: 

AVAR ■ CXO + CXl*x + CX2*X 2 + CX3*x 3 

D 

Real 


diam ® t ® r of shock tube in cm; used to compute 
| LSUBM for a shock kinetic case 

DBUGO 

Logical 

TRUE 

FALSE 

i.onal intermediate output is to be printed 
Only standard output is to be printed 




END 

Real 


Value of independent variable at which integration is to 
be terminated? integration is stopped when the solution 
has been advanced to an independent variable value that 
either exceeds or is equal to END 

ETA 

Real 


Dimensionless exponent in special area equation for a 
shock kinetic problem 

EXCHR 

Logical 

TRUE 

FALSE 

Print energy exchange rate for each reaction 
Print net reaction conversion rate for each reaction 




HTRAN 

Logical 

TRUE 

FALSE 

Heat transfer between reacting system and environment is 
to be considered 

Heat transfer rate not required: either the temperature is 
assigned, or the reacting system is adiabatic 




HTO 

Real 


Coefficients in the polynomial heat transfer rate (0 or 
Q ) equation as a function of temperature (T) : 

Q (or Q') = HTO + HT1*T + HT2*T 2 + HT3+T 3 ♦ HT4 *T 4 

HT1 


HT2 



HT3 



HT4 




IPRINT 

Integer 


Number of integration steps between output of results- 
default value =5 


LSUBM 

Real 


Characteristic reaction length in cm for nhnrif i-hK** 

: — j 
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ORDER 

Logical 

TRUE 

FALSE 

OTTO 

Logical 

TRUE 

FALSE 

PC 

Real 


PCON 

Logical 

TRUE 

FALSE 

PRINT 

Real 


QMREAD 

Logical 

TRUE 

FALSE 

RHOCON 

Logical 

TRUE 

FALSE 

ROCKET 

Logical 

TRUE 

FALSE 

RPM 

Real 


RXNTST 

Logical 

TRUE 

FALSE 

SENCAL 

Logical 

TRUE 

FALSE 

SENSTD 

Logical 

TRUE 

FALSE 

SHOCK 

Logical 

TRUE 

FALSE 

STROKE 

Real 


TASS 

Logical 

TRUE 

FALSE 

TCON 

Logical 

TRUE 

FALSE 

TINY 

Doubl e 
precision 


TOTMAS 

Real 


TTB 

Real 



An ordered list of nonzero formation rates of all species 
due to each reaction is to be generated 

List of species formation rates by individual reactions is 
not required 

Built-in correlations are to be used to compute internal 
combustion engine heat transfer rate for assigned pressure 
static problem 

Built-in correlations are not needed for heat transfer 
computation 

Rocket chamber pressure in psia 

Pressure is assigned constant for a static or flow 
reaction 

Pressure may change during the reaction 

Array of integration variable values at which output is 
desired; maximum number allowed = 100 

Heat transfer rate is given by a polynomial function of 
temperature 

Heat transfer correlations built into code are to be used 
for heat transfer rate computations 

Density (volume) is to be held constant for a static 
reaction case 

Density is allowed to vary 

Rocket performance parameters are to be computed for a 
flow problem 

Rocket performance need not be computed 

Engine speed in rpm; used for heat transfer computation 
when OTTO = TRUE; default value = 1000 

Reaction mechanism must be checked for duplicate reactions 
and other inconsistencies 

Reaction validity checking need not be done 

Sensitivity coefficient computations are required 
Sensitivity analysis is not needed 

Sensitivity coefficients of temporal derivatives of 
dependent variables are required 

Sensitivity coefficients of temporal derivatives of 
dependent variables are not required 

An incident shock kinetic computation is to be performed 
Incident shock computation is not needed 

Length of piston used for computing heat transfer 
coefficient when OTTO * TRUE; default value = 8 cm 

An assigned temperature problem is to be performed; 
Namelist TMPDAT must follow PROB (see item 6) 

A temperature profile will not be assigned 

The temperature is to be held constant 
Temperature may change during the reaction 

Smallest nonzero value allowed for normalized sensitivity 
coefficients; default value = 0.0 

Total reacting mass for a static problem with heat 
transfer rate given by polynomial equation 

Array of times when specifying area or pressure in tabular 
form as a function of time; values correspond to those in 
the ATB array; maximum number of points = 100 
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TWALL 

Real 

— 

Wall temperature used with heat transfer correlation 
equations 

vise 

Real 


Standard state dynamic viscosity in g/(cm s) ; used to 
compute LSUBM for a shock kinetic case 

WELSTR 

Logical 

TRUE 

FALSE 

A perfectly stirred reaction (PSR) computation is to be 
performed; Namelist WSPROB must follow PROB (see item 7) 
A PSR computation is not required 

WSFLOW 

Logical 

TRUE 

FALSE 

A flow problem computation is to be performed after a PSR 
problem, using the PSR results for composition, 
temperature and density; Namelist WSPROB must follow PROB 
(see item 7) 

A flow problem does not follow the PSR problem 

XTB 

Real 

i 

Array of distances if pressure or area is to be specified 
in tabular form as a function of distance; values 
correspond to those in the ATB array; maximum number of 
points * 100 


( 1) In tabular form as a function of either time or distance. 

(2) A polynomial function of either time: 

p = CTO + CTl*t + CT2*t 2 + CT3*t 3 , 

or distance: 


p = CXO + CXl*x + CX2*x 2 + CX3*x 3 . (H.H) 

To select method (1) the pressure values must be set in the array ATB and either the corresponding time 
values in the array TTB or the corresponding distance values in the array XTB. A p-t profile via method (2) is 
specified by means of nonzero values for one or more of the four coefficients CTO, CT1, CT2, and CT3. A p-x 
profile is given by assigning nonzero values for one or more of the four coefficients CXO, CXI, CX2, and CX3. 
A goqstapt pressure calculation can be performed by setting a nonzero value for only CTO (or CXO), which 
must be set equal to the desired pressure. An alternative method of specifying a constant pressure problem is to 
set the logical variable PCON equal to TRUE. The pressure will then be held constant at its user-supplied 
initial value (see item 8, “Initial Conditions”). The combination of the switch PCON equal to TRUE and a 
nonzero value for (only) CTO or CXO will also work. 

A” M gjgted area flow problem is selected by means of the keyword AREA on the Integration and 
Assigned Variables, Units and Fuel Name line, as described in item 4. The area can be given as a function of 
either time (t) or distance (x), independently of the choice of integration variable. One of the following two 
methods can be used to specify A: 

(1) In tabular form as a function of either time or distance. 

(2) A polynomial function of either time: 


A = CTO + CTl*t + CT2*! 2 + CT3*t 3 , 


or distance: 


( 11 . 12 ) 


A = CXO + CXl*x + CX2*x 2 + CX3*x 3 . 


(11.13) 




To select method (1) the area values must be set in the array ATB and either the corresponding time values 
in the array TTB or the corresponding distance values in the array XTB. An A-t profile via method (2) is speci- 
fied by means of nonzero values for one or more of the four coefficients CTO, CT1, CT2, and CT3. An A-x 
profile is given by assigning nonzero values for one or more of the four coefficients CXO, CXI, CX2, and CX3. 
A constant area calculation can be performed by setting a nonzero value for only CTO (or CXO), which must be 
set equal to the desired area. An alternative method of specifying a constant area problem is to set the logical 
variable ACON equal to TRUE. The area will then be held constant at its user-supplied initial value (see item 
8, "‘Initial Conditions”). The combination of the switch ACON equal to TRUE and a nonzero value for (only) 
CTO or CXO is also valid. 

Constant temperature problem . - For either a static or flow problem, including that following a PSR calcu- 
lation, a constant-temperature calculation can be performed by setting the logical variable TCON equal to 
TRUE. The temperature will then be held constant at its user-supplied initial value (see item 8, “Initial Condi- 
tions”). This option cannot be used for the flow problem following an incident shock calculation. Another 
method of specifying a constant-temperature calculation is described in the next subsection. 

Assigned temperature problem . - For a static or flow problem, except that following either an incident 
shock or PSR calculation, the temperature profile can be given, as described in item 6. To select this option the 
logical variable TASS must be set equal to TRUE. The option can also be used to perform a constant tempera- 
ture calculation (see item 6 for details). 

Sensitivity analysis . - This option can be selected for a static problem only. To indicate that sensitivity 
coefficients are to be computed, the logical variable SENCAL must be set equal to TRUE. If sensitivity coeffi- 
cients of the temporal derivatives of the dependent variables are also required, the logical variable SENSTD 
should be set equal to TRUE. Another variable that both controls the sensitivity computations and is set in 
PROB is TINY (default value = 0.0), which is the magnitude of the smallest normalized sensitivity coefficient 
that can be considered significant. Any normalized coefficient that is smaller in magnitude than TINY will be 
set equal to zero. 

Chemical equilibrium computations . - To select this option the logical variable COMBUS must be set 
equal to TRUE. The code assumes that a chemical equilibrium computation is being performed only to obtain 
additional information concerning a kinetics problem. Therefore a legal kinetics problem must be specified. 

Also, since the species list is constructed from the reaction mechanism, the latter must contain all species impor- 
tant to the equilibrium problem. 

Depending on the kinetics problem specified, the code will automatically compute the equilibrium results 
for one of the following four assigned states: (a) specific enthalpy and pressure (HP), (b) temperature and pres- 
sure (TP), (c) specific internal energy and specific volume or density (UV), and (d) temperature and specific 
volume or density (TV). An assigned volume calculation (UV or TV) is executed for a constant density kinetics 
problem, that is, when the logical variable RHOCON is set equal to TRUE. For all other kinetics problem types 
an assigned pressure calculation (HP or TP) is done. In either case, an assigned temperature equilibrium solu- 
tion (TP or TV) is produced for a constant-temperature kinetics problem. For a nonconstant-temperature kinet- 
ics problem either an HP or a UV computation is executed, depending on the value of RHOCON. 

If the user is solely interested in the results of the chemical equilibrium computation, the reaction mecha- 
nism and rate coefficient parameters are unimportant. Hence, any mechanism that contains all required species 
may be used, nonzero values specified for only the pre-exponential factors and all reactions made irreversible to 
increase the efficiency of the kinetics computation. Indeed, the reactions do not even have to satisfy atom and 
charge balance requirements. However, in this case, an error exit may occur during the kinetics computation. 
Also, reaction mechanism legality testing (see below) must not be required. Finally, in the interest of efficien- 
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cy, only one print station (see below), very close to the initial value of the integration variable, should be sped- 
fied. v 


Shock tube reaction . - To compute the equilibrium and frozen conditions behind an incident shock wave 
the logical variable SHOCK must be set equal to TRUE. The incident shock computations are followed by a 
one-dimensional flow problem with area assigned as a function of distance. In particular, the area profile is 
given by the special function, equation (9.4). The exponent ETA (= q) in this equation must be specified The 
user must also give either the characteristic length LSUBM (= LJ or the three quantities, shock tube hydraulic 
diameter, D (- d H ), unshocked gas dynamic viscosity, VISC (= p,) and the boundary layer thickness parameter, 
BETA (- p), so that the code can compute L^. Finally, since the species list is constructed from the reaction 
mechanism, the latter must contain all species important to the shock computations. 

If the user is solely interested in studying post-shock equilibrium and/or frozen conditions, the reaction 
mechanism and rate coefficient parameters are unimportant. Hence, any mechanism that contains all required 
species may be used, nonzero values specified for only the pre-exponential factors and all reactions made irre- 
versible to increase the efficiency of the kinetics computation. Indeed, the reactions do not even have to satisfy 
atom and charge balance requirements. However, in this case, an error exit may occur during the kinetics com- 
putation. Also, reaction mechanism legality testing (see below) must not be required. Finally, in the interest of 

efficiency, only one print station (see below), very close to the initial value of the integration variable, should be 
specified. 

Perfectly stirred reactor (PSR) problem . - For solving a PSR problem the logical variable WELSTR should 

be set equal to TRUE. The type of problem to be solved and the required variables are specified elsewhere as 
described in item 7. 

C ombined PSR and plug flow problem . - A plug flow calculation may be performed after a PSR problem 
m a single computer run. Such a two step process is sometimes used as a simplified model of a gas turbine 
combustor. To solve this type of problem the logical variable WSFLOW must be set equal to TRUE. The 
variables required for the PSR computation must be given elsewhere, as described in item 7. For the flow prob- 
lem the assigned variable (pressure or area) and its profile must be specified. 

S ummary . - The variables that must be set in PROB for the different problem types and options considered 
above are summarized in table 1 1.5. For a flow problem following a PSR problem, either pressure or area may 
be assigned, by means of the profiles (and variables) given in this table. However, temperature may be assigned 
only as constant, and that too only by means of the flag TCON: the option TASS = TRUE cannot be used. But 
pressure or area may be assigned as constant in any of the ways described previously. Finally, temperature 
cannot be assigned for the flow problem following a shock computation. 

Heat Transfer Models . - Any static or flow reaction problem may be nonadiabatic, with an assigned heat 
transfer rate. The logical variable HTRAN must be set equal to TRUE to indicate that the heat transfer rate is 
required. The heat transfer rate, Q, for a static problem or the heat transfer rate per unit length in direction of 
flow, Q', for a flow problem, can be specified by one of the following two models: 

(1) A polynomial function of up to fourth degree in temperature (T): 

Q (or Q') = HTO + HT1*T + HT2*T 2 + HT3*T 3 + HT4*! 4 . (I U4) 

(2) Built-in standard heat transfer correlations (see eqs. (8.22) to (8.31)). 
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TABLE 1 1.5 - VARIABLES THAT MUST BE SET IN NAMELIST PROB FOR THE DIFFERENT 
PROBLEM TYPES AND RELATED OPTIONS a BUILT INTO CODE 


Problem type or option 

Variables that must be set in namelist PROB 

Constant density static 

RHOCON (= TRUE) 

Constant pressure static 

PCON (= TRUE) and/or CTO 

Assigned pressure static, with pressure specified: 


(a) As a polynomial function of time 

(b) In tabular form as a function of time 

One or more of CTO, CT1, CT2, and CT3 
ATB; and TTB 

Constant pressure flow 

PCON (= TRUE) and/or one of CTO and CXO 

Constant area flow 

ACON (= TRUE) and/or one of CTO and CXO 

Assigned pressure or area flow, with assigned 
variable specified: 


(a) As a polynomial function of time 

(b) In tabular form as a function of time 

(c) As a polynomial function of distance 

(d) In tabular form as a function of distance 

One or more of CTO, CT1, CT2, and CT3 
ATB; and TTB 

One or more of CXO, CXI, CX2, and CX3 
ATB; and XTB 

Constant temperature static or flow b,c 

TCON (= TRUE) 

Assigned temperature static or flow d 

TASS (= TRUE) 

Sensitivity analysis e 

SENCAL (= TRUE); and, possibly, 
SENSTD (= TRUE) and TINY 

Chemical equilibrium 

COMBUS (= TRUE) 

Incident shock 

ETA; either LSUBM or all three of BETA, D and 
VISC; and SHOCK (= TRUE) 

Perfectly stirred reactor 

WELSTR (= TRUE) 

Perfectly stirred reactor plus plug flow 

WSFLOW (= TRUE); variables that depend on the 
assigned variable and its profile, as described above; 
and, for constant temperature flow, 

TCON (= TRUE). 


a Except those related to heat transfer. 

b An alternative method of specifying a constant temperature problem is to set TASS = TRUE in PROB and 
the appropriate variable in namelist TMPDAT (see table 1 1.8). 

c This option cannot be used for a flow problem following an incident shock computation. 

< *This option cannot be used for a flow problem following either an incident shock or a PSR computation. 
c This option can be selected for a static problem only. 
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Only the second heat transfer model may be specified for the assigned pressure, variable-volume Otto-cycle 
engine static problem. All other static problems may use only the first model. For flow problems, however, 
either model may be selected. 

To select the first heat transfer model, which is the default option corresponding to QMREAD = TRUE 
(see table 1 1.4), nonzero values must be given for one or more of the five coefficients HTO, HT1, HT2, HT3, 
and HT4 in equation (1 1.14). In addition, for a static problem the total mixture mass TOTMAS must be sup-' 
plied. 


To use the second heat transfer model, QMREAD must be set equal to FALSE and the Transport Properties 
Data File made available. The wall temperature, TWALL (= T w in eq. (8.22)) must also be specified. Finally, 
for the Otto-cycle model the variable OTTO must be set equal to TRUE and values given for engine speed 
RPM (in revolutions per minute), and cylinder bore BORE and stroke STROKE. 


In summary, if heat transfer is to be considered, the required information depends on both the problem type 
and the heat transfer model. Table 1 1.6 lists the variables which must be specified for heat transfer computa- 
tions. The default value for QMREAD is TRUE, so this quantity need not be set if the heat transfer rate is 
given as a polynomial function of temperature. However, we recommend supplying QMREAD if the Problem 
Data File contains several problems, and have therefore included it in table 1 1 .6. 


TABLE 1 1.6 - VARIABLES THAT MUST BE SET IN NAMELIST PROB 
FOR HEAT TRANSFER COMPUTATIONS 


Problem type 

Heat transfer model 

Variables that must be set in 
namelist PROB 

Constant density 
static 

Polynomial function of 
temperature 8 

HTRAN (= TRUE); one or more 
of HTO, HT1, HT2, HT3, and 
HT4; QMREAD (= TRUE) b ; 
and TOTMAS 

Assigned pressure 
static 

Polynomial function of 
temperature 

HTRAN (= TRUE); one or more 
of HTO, HT1, HT2, HT3, and 
HT4; QMREAD (= TRUE) b ; 
and TOTMAS 


Built-in correlations 

BORE; HTRAN (= TRUE); 
OTTO (= TRUE); QMREAD 
(= FALSE); RPM; STROKE; 
and TWALL 

Assigned pressure 
or area flow 

Polynomial function of 
temperature 

HTRAN (= TRUE); one or more 
of HTO, HT1, HT2, HT3, and 
HT4; and QMREAD (= TRUE) b 


Built-in correlations 

HTRAN (= TRUE); QMREAD 
(= FALSE); and TWALL 


“This is the only heat transfer model allowed for constant density static 
problems. 

HThe default value for QMREAD is TRUE. 



Reaction Mechanism Tests . - The logical variable RXNTST controls whether or not the the legality of the 
reaction mechanism is tested. Setting RXNTST equal to TRUE tells the code to check that no reaction is dupli- 
cated and that each reaction satisfies charge and atom balance requirements. We strongly recommend that this 
option be used when either developing or preparing a new mechanism. 

Print Stations . - The user has a choice of three options (in Namelist PROB) for specifying when the solu- 
tion is to be generated. The results may be printed at designated values of either (1) the integration variable (£) 
or (2) assigned variable. The third option is the printout of solution at intervals of a prescribed number of inte- 
gration steps. For the flow reaction problem behind an incident shock wave only the first or third option may 
be used. For all other flow problems, including that following a PSR problem, any option may be selected. The 
same is true for any static kinetics-only or kinetics-plus-sensitivity problem. 

To use the first option the output stations, that is, £ values at which the solution is required, must be en- 
tered into the array PRINT. The output station values must be listed in order of increasing £. Any output sta- 
tion that is either less than or equal to the previous one will be ignored. The same is true of any output station 
that is not greater than the user-supplied initial value of ^ (see item 8, “Initial Values 44 ). 

The second option may be selected only if the assigned variable is specified in tabular form, and that too 
only as a monotonic function of £. To use this option the assigned variable values at which output is required 
must be entered into the array APRINT. Also, they must be ordered such that the resultant £ values at which 
output is produced increase. That is, if the values in ATB increase monotonically, so should the APRINT val- 
ues, and vice versa. 

To use the third option values must be given for the integer variable IPRINT (= the number of integration 
steps between output of results) and the real variable END (= the £ value at which the integration is to be termi- 
nated). The integration is stopped on the first step for which £ > END and the results computed on this step are 
printed. 

The above three methods are summarized in table 1 1.7, which also lists the variables that must be set in 
PROB. A fourth method, described under item 6, may be used for a certain type of assigned temperature prob- 
lem. If this option will be used, data concerning output frequency must not be given in PROB. 


TABLE 1 1.7 - OPTIONS THAT SPECIFY WHEN OUTPUT IS TO BE GENERATED AND 
VARIABLES THAT MUST BE SET IN NAMELIST PROB FOR EACH OPTION 


When is output required? 4 

Variables that must be 
set in namelist PROB 

At specified values of the integration variable 

PRINT 

At specified values of the assigned variable (area or pressure)* 5 

APRINT 

At intervals of a specified number of integration steps 0 

IPRINT; and END 


a See item 6 for a fourth method of specifying print stations. 

^In this case, the assigned variable must be specified in tabular form, and that too only as a 
monotonic function of the integration variable. Also, values must be entered into APRINT 
in the same order (i.e., increasing or decreasing values) as in ATB. 

c In this case, output is also produced after the problem is completed, i.e., at the value (> END) 
of the independent variable reached on the final integration step. 
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(6) Assigned Temperature Profile (Namelist TMPDAT) 

For an assigned temperature problem, that is, TASS = TRUE in PROB, the required data should be set in a 
namelist called TMPDAT, which must follow PROB. In addition to the temperature profile, the namelist con- 
tains an option for specifying when output is to be generated. Following is a complete list and description of 
the variables in TMPDAT: 


Variable 

name 

Variable 
type ; 

Explanation 

CTO 

CT1 

CT2 

CT3 

Real 

Coefficients in the polynomial equation for temperature (T) as a function 
of time (t): 

T = CTO + CTl*t + CT2*t 1 2 + CT3*t 3 

CXO 

CXI 

CX2 

CX3 

Real 

Coefficients in the polynomial equation for temperature (T) as a function 
of distance (x): 

T = CXO + CXl*x + CX2*x 2 + CX3*x 3 

TMPTB 

Real 

Table of temperatures when assigning temperature in tabular form as a 
function of time or distance; maximum number of values = 100 

TPRINT 

Real 

Table of temperatures at which printout is desired; maximum number of 
print stations = 100 a 

TTB 

Real 

Array of times when specifying a temperature table as a function of time; 
values correspond to those in TMPTB; maximum number of points = 100 

XTB 

Real 

Array of distances when specifying a temperature table as a function of 
distance; values correspond to those in TMPTB; maximum number of 
points = 100 


a In this case, the temperature must be specified in tabular form, and that too only as a monotonic 
function of the integration variable. Also, values must be entered into TPRINT in the same 
order (i.e., increasing or decreasing values) as in TMPTB. 


For a flow problem the temperature can be given as a function of either time or distance, independently of 
the choices of the integration variable and the independent variable for the assigned variable. One of the fol- 
lowing two methods can be used to specify the temperature (T): 

(1) In tabular form as a function of either time or distance. 

(2) A polynomial function of either time (t): 

T = CTO + CTl*t + CT2*1? + CH*^, (11.15) 


or distance (x): 
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TABLE 1 1.8 - VARIABLES THAT MUST BE SET IN NAMELIST TMPDAT 
FOR AN ASSIGNED TEMPERATURE PROB LEM 


Temperature 

profile 

Temperature 
profile type 

Variables that must be set in namelist 
TMPDAT 

Temperature 
versus time 

Constant* 

Polynomial 

Tabular 

CTO 

One or more of CTO, CT1, CT2, and CT3 
TMPTB; and TTB 

Temperature 
versus distance 

Constant* 

Polynomial 

Tabular 

CXO 

One or more of CXO, CXI, CX2, and CX3 
TMPTB; and XTB 


'See table 1 1.5 for an alternative method of specifying a constant temperature 


I = CXO + CXl*x + CX2*x / + CX3*x 3 


(11.16) 
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The user can require printout of the solution at specified values of the temperature, but only if it is 
assigned in tabular form, and that too only as a monotonic function of the integration variable To use this 
option the temperature values at which output is required must be entered into the array TPRINT Also they 
must be ordered such that the resultant « values at which output is produced increase. Vha UJf thJ^in 
TMPTB increase monoton, cally, so should the TPRINT values, and vice versa. Finally, no print stlfion infer 
mation must have been given in PROB (see item 5 and table 1 1.7). 
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(7) Perfectly Stirre d Reactor Problem Data (Namelist WSPROB) 

For a PSR problem, that is, WELSTR and/or WSFLOW = TRUE in PROR fh«> r^mAr^A At 
a namelist called WSPROB, which must follow PROB. The type of PSR computational is assignedmaTs 
flow rate or assigned temperature, is specified here. In either case, a sequence of PSR solutions is generated 
' desired condition is reached. The required data for each problem type and heat transfer and output 
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Variable 

name 


Variable 

type 


Value 


Explanation 


DELMD 

Real 


Mass flow rate increment for an assigned mass flow rate problem 

DELT 

Real 


Temperature decrement (absolute value) for an assigned temperature 
problem. 

DOTMAX 

Real 


Desired mass flow rate for an assigned mass flow rate problem. 

DTMAX 

Real 


Maximum temperature decrement desired for an assigned temperature 
problem; temperature at reactor exit will be set equal to 
(TEQ - DTMAX), where TEQ is the equilibrium temperature for the 
inlet state. 

MPR 

Integer 


Control variable for printout; printout occurs after first and, thereafter, 
every MPRth convergence: default value = 1 

RITE 

Logical 

TRUE 

FALSE 

Extra debug output will be printed on every iteration 
Only standard output will be printed 

TMPMIN 

Real 


! 

Desired temperature at reactor exit for an assigned temperature problem 

VOLUME 

Real 


Volume of the reactor 

WSRHTR 

Logical 

TRUE 

FALSE 

! 

Problem is not adiabatic and heat transfer rate will be computed using a 
polynomial equation 
Reactor is adiabatic 

WSRHTO 

WSRHT1 

WSRHT2 

WSRHT3 

WSRHT4 

Real 

— 

Coefficients in the heat transfer rate (Q) versus temperature (T) 
expression: 

Q = WSRHTO + WSRHT1*T + WSRHT2*T 2 + WSRHT3*T 3 + 
WSRHT4*! 4 


To select an assigned mass flow rate problem the variable DELMD must be set equal to the desired mass 
flow rate increment between successive solutions. Also, DOTMAX, the desired mass flow rate through the 
reactor, must be given. For an assigned temperature problem the variable DELT, which is the temperature 
decrement between successive solutions, must be set. (The first solution is attempted with a temperature of 
(TEQ - DELT), where TEQ is the equilibrium temperature for the reactor inlet state.) The user must also assign 
a value for either DTMAX, the maximum temperature decrement, or TMPMIN, the desired temperature at reac- 
tor exit. If DTMAX is given the reactor exit temperature will be set equal to (TEQ - DTMAX). If both 
DTMAX and TMPMIN are specified, the value min(TMPMIN, TEQ - DTMAX) will be assigned for the exit 
temperature. 

For both problem types the variable VOLUME must give the reactor volume. If the problem is not adia- 
batic and heat transfer must be considered, the logical variable WSRHTR should be set equal to TRUE. Also, 
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TABLE 1 1.9 - VARIABLES THAT MUST BE SET IN NAMELIST WSPROB FOR A PERFECTLY 

QTTDDun DUA^n roRrcuLI 


Problem type 

Variables that must be set in namelist WSPROR b 

Assigned mass flow rate 

DELME); DOTMAX; MPR; VOLUME; and, for a problem with heat 
ransfer, WSRHTR (- TRUE) and one or more of WSRHTO WSRHTI 
WSRHT2, WSRHT3, and WSRHT4 

Assigned temperature 
... . 

DELT; DTMAX and/or TMPMIN; MPR; VOLUME; and, for a problem 

5** tramfer ’ w SRHTR (= TRUE) and one or more of WSRHTO. 
WSRHTI, WSRHT2, WSRHT3, and WSRHT4 


TRUE in namelist PROB (s^ item 5) 8 ' C 6 

^uaHo TRUE f0rmati ° n Wil1 ** " **** * the logical variable RITE 1 


is set 


zr in ,he fo " owing equa,ion for ,he heai 

Q = WSRHTO + WSRHTI *T + WSRHT2*T 2 + WSRHT3*T 3 + WSRHT4*! 4 (1 1 \j) 

se. i„ T WSPROB m TT *Sr l r“ fl ° W rate " “ s « ne<l dictates what variables must be 

h , "" SP , R ° B - ,™ e *“ re «i u " ”d fo t •»* ptoblem types are summarized in table 1 1.9. I, should be noted 

t md and DELT ' 50 — -* - * ^ 

item 8, Initial Conditions”) may also have to be adjusted. 

(8) Initia l Conditions (and Namelist START) 

assigned in TOot Tncior **} T* °* ** mUSt P rovided - Unless already 

in a namelist called START, which will follow PRO™ T^p^ATTr 1 WSPRt3B a ^ependin bleS T"* be initialized 
Time and distance may also be initialized in START Final Ivifrhl £?’ depending on the P roblem ‘YPe* 
the necessary variab.es am set here; otherwise, the mixture cLpo.it^ ^ 

the concentrations may be input as either mole or mass fractions The logic! v aril! i5SeF in START T 

tit :r,™ aon un,B are used ' - ^ 
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Variable 

name 

Variable 

type 

Value 

Explanation 

AIRMW 

Real 


Molar mass of oxidant; default value = 28.9644 

AREA 

Double 

precision 


Initial area 

ARAT 

Real 


Ar/0 2 mole ratio in oxidant; default value = 0.044487 

CRAT 

Real 


C0^0 2 mole ratio in oxidant; default value = 0.001432 

ERATIO 

Real 


Fuel-oxidant equivalence ratio 

FLAIR 

Real 


Fuel-oxidant mass ratio 

MACH 

Real 


Initial Mach number or Mach number of gas flowing 
into incident shock 

MDOT 

Double 

precision 


Mass flow rate for flow problem. For PSR problem mass 
flow rate either assigned for first solution or to 
start iteration for assigned temperature calculation 

MMHG 

Logical 

TRUE 

FALSE 

Pressure P (see below) is given in torr (millimeters of 
mercury) 

Pressure P is given in the user’s chosen input units 

MOLEF 

Logical 

TRUE 

FALSE 

Species concentrations will be given in mole fractions 
Species concentrations will be given in mass fractions 

NOXRAT 

Real 


Ng/Og mole ratio in oxidant; default value = 3.72735 

P 

Double 

precision 


Initial pressure or unshocked gas pressure or reactor 
pressure 

RHO 

Double 

precision 


Initial density or unshocked gas density or reactor 
inlet density 

see 

Real 


Stoichiometric coefficient of carbon in fuel; default 
value = 0.0 

SCH 

Real 


Stoichiometric coefficient of hydrogen in fuel; default 
value = 0.0 

SCOX 

Real 


Stoichiometric coefficient of oxygen in fuel; default 
value = 0.0 

T 

Double 

precision 


Initial temperature or unshocked gas temperature or 
reactor inlet temperature 

TIME 

Double 

precision 


Initial time 

V 

Double 

precision 


Initial velocity or shock velocity 

X 

Double 

precision 


Initial distance 
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the molar ratios of argon, carbon dioxide and nitrogen to oxygen, rLpectively Tfot if f 

^==£S;=5*r* 

Irrespective of the method used, MOLEF must not be set eoual m fai <;f *u , „ 

Assigned Variables, Units and Fuel Name line must ontableTe ameOee 'kTT Tt 

me.h„d S the variable, ,ha, must be se, in START are summarized^ X mo ° f "* ' W ° 

For anv kinetics problem, including that following an incident shock or PSD p nmn „ tot ’ 
tance may be initialized by entering the desired values into TIME and X respectively Bot^variabl ^ " 

tialized to zero before START is read, so the user needs to specify only IhTn^one^ ^ 

Other quantities that have to be initialized in START Am&nA 

* ” Par “ K 7 " ~ 8 d , he 

and r^^^.^^a^nrt^N^'assten^^Th^DAT ^se^terra^ar^^^ta^js'case e^TAS^- FALSE)^ dre 
mural (or constant) temperature must be entered into the variable T. Note that T must teroecified eveffa^ 

TMPDATTo r :' l,re * lect « l »V means of the flag TCON, if a temperature value is M given " 

, a eVer ’ ^ a tem P erature profile, constant or otherwise, has been prescribed in TMPDAT T mi 

The remaining variables whose initial values must also be set in <?TAPT ara „ c r ■■ - 

either pressure („ or density (RHO) 


TABLE 1 1.10. - VARIABLES THAT MUST BE SET IN NAMELIST START IF THF cimdi icier. 
COMPOSITION input r»DTir.M TO T ICrr\ « _ SIMPLIFIED 


Quantity used to specify initial 
mixture composition 

— X usiiim. iVii^x UTxn I 

Variables that must be set in namelist START 15 

Fuel-oxidant equivalence ratio 

ERATIO; SCC; SCH; SCOX; and, if oxidant composition is dif- 
ferent from the standard one, ARAT, CRAT and NOXRAT 

Fuel -oxidant mass ratio 

am u ~ . i 

FLAIR; and, if oxidant composition is different from the standard 
one, AIRMW, ARAT, CRAT, and NOXRAT 


wu uiv iiu^giauuii anu / 

(see item 4). 

^MOLEF must not be set equal to FALSE in START. 
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lem no additional variable needs to be set if the pressure profile has been furnished in PROB. However, if the 
flag PCON had been used in PROB to denote constant pressure, but its value not given there, either pressure (P) 
or density (RHO) must be set. 

For an assigned pressure flow problem with a pressure profile supplied in PROB two of the following 
three variables must be given: (i) mass flow rate (MDOT), (ii) area (AREA) and (iii) either velocity (V) or 
Mach number (MACH). However, if the flag PCON had been used in PROB to denote constant pressure, but 
its value not given there, either pressure (P) or density (RHO) must also be set. An alternative that will work in 
this case is to set all three variables (i) MDOT, (ii) AREA and (iii) either V or MACH. 

For an assigned area flow problem with area profile provided in PROB, the user must set two of the fol- 
lowing three variables: (i) either pressure (P) or density (RHO), (ii) mass flow rate (MDOT) and (iii) either 
velocity (V) or Mach number (MACH). However, if the flag ACON had been used in PROB to denote con- 
stant area, but its value not given there, area (AREA) must also be set. Alternatively, values may be assigned 
for the three variables (i) either P or RHO, (ii) MDOT and (iii) either V or MACH. 

Incident Shock Problem . - For this problem type values must be given for the variables T (= unshocked 
gas temperature) and either P (= unshocked gas pressure) or RHO (= unshocked gas density). Also, either the 
variable V must be set equal to the shock velocity or a value assigned for MACH, the ratio of the shock veloci- 
ty to the sonic velocity in the unshocked gas, that is, the quantity A/j in equation (9.5). 

PSR Problem . - For both problem types the reactor inlet temperature (T) and either reactor pressure (P) or 
reactor inlet density (RHO) must be supplied. The user must also set MDOT, which is the mass flow rate either 
(a) for the first solution of an assigned mass flow rate problem or (b) to start the iteration for the first solution 
of an assigned temperature problem. 

PSR-plus-Plug Flow Problem . - For the PSR calculation the user must set T equal to the reactor inlet tem- 
perature and MDOT equal to the mass flow rate that is either (a) the first solution of an assigned mass flow rate 
problem or (b) the initial guess for the first solution of an assigned temperature problem. 

The flow problem following the PSR calculation dictates what other variable(s) must be set in START. 

For an assigned pressure flow problem the user must supply a value for one of the three variables (i) AREA (= 
initial area), (ii) V (= initial velocity) and (iii) MACH (= initial Mach number). In addition, if a pressure profile 
has not been prescribed in PROB, either P (= reactor pressure) or RHO (= reactor inlet density) must be set. 

This situation arises when a constant pressure flow problem is selected via the flag PCON but a pressure value 
not given in PROB. 

For an assigned area flow problem either P (= reactor pressure) or RHO (= reactor inlet density) must be 
specified. In addition, if a constant area flow problem has been specified via the flag ACON but an area value 
not given in PROB, the user must set one of the three variables (i) AREA (= initial area), (ii) V (= initial veloc- 
ity) and (iii) MACH (= initial Mach number). 

Summary . - The thermodynamic and fluid dynamic variables that must be initialized in START depend on 
the problem type, related options and information given in PROB and TMPDAT. For each problem type and 
related option we list these variables in table 11.11. Finally, if the pressure is required, P may be given in 
either the input units selected by the user or torr (millimeters of mercury). In the latter case, the logical variable 
MMHG must be set equal to TRUE in START. 

Initial Mixture Composition . - Immediately following START, the initial (or reactor inlet) mixture compo- 
sition is specified by listing the species names and their initial (or inlet) concentrations, which are interpreted as 
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TABLE .ML - SU “ ^ ™®MODYNAMC AND FLUID DYNAMIC VAR, ABLES WHOSE 


Problem type 

Assigned vari- 
able specified in 
namelist PROB? 

Variables whose initial values must be set in 
namelist START 

Constant density static 

No 8 

TIME b ; P or RHO; and T 

Constant pressure static 

No d 

Yes 

TIME b ; P or RHO; and T* 
TIME b ; and T 0 

Assigned pressure static 

Yes 

TIME b ; and T 0 

Constant pressure flow 

No d,e 

Yes 

TlME b ; X b ; P or RHO; two of MDOT, 
AREA, V (or MACH); and T 6 
TIME b ; X b ; two of MDOT, AREA, V (or 
MACH); and T 

Assigned pressure flow 

Yes 

TlME b ; X b , two of MDOT, AREA, V (or 
MACH); and r 

Constant area flow 

No f 

Yes 

TIME b ; X b ; AREA; two of P (or RHO), MDOT 
V (or MACH); and V 

TIME b ; X b ; two of P (or RHO), MDOT, V (or 
MACH); and T® 

Assigned area flow 

Yes 

TIME b ; X b ; two of P (or RHO), MDOT, V (or 
MACH); and r 

Incident shock kinetics** 

Yes (see item 5) 

riME b ; X b ; P (or RHO); V (or MACH); and T 

Perfectly stirred reactor* 1 

None required 

P (or RHO); MDOT; and T 

Perfectly stirred reactor-plus-plug flow^* 

See item 5 

TIME 0 ; X b ; P (or RHO) 1 ; MDOT; T; and 
AREA* 


^Density cannot be assigned in PROB. 

time and di8tanCC ^ t0 be giVCn 0n 'y if the y are different fro"! zero. 

Not needed if temperature is assigned in namelist TMPDAT (see item 6). 

”nis combination obtained only by setting PCON = TRUE in PROB 

v <: s K r d ? lowi " 8 variab,x *-* - TmVx?? r,s^ may 

^Initial values are for pre-shock state. 

"The thermodynamic properties are for the inlet state. 

a . rCa ‘ S tfle aS8i S ned variable or a instant pressure flow problem is specified by means of the 
PCON switch and pressure not supplied in PROB. y tne 

' APON d ''I Pre9SUre ' S the aSSigned Var ' able ° r 3 C ° nStant area flow P rob,em is specified via the option 
TjSSL- “ “ PROB ' ei,h “ - ““ "*»* V (or MACH) 


92 




either mole or mass fractions, depending on the value assigned to MOLEF. The default concentration, corre 
sponding to MOLEF = TRUE, is mole fraction. For each species the data are given on a new line, which is 
read using the format (A8, 2X, FI 5. 13). The species name is written, starting in column 1, exactly as in the 
chemical reactions. The species mole or mass fraction is written in columns 1 1 to 25, in either fixed or floating 
point format. All concentrations are initialized to zero, so only species with nonzero initial concentrations need 
to be included in the composition list. The end of this list is signaled by a line that either is blank or contains 
the word END in columns 1 to 3. 

Even if the simplified composition input option is used, the above list of species names and mole fractions 
may be given. This feature enables the user to include some trace species in the initial mixture. However, the 
sums of the mole and mass fractions of all species must not exceed unity by more than 10 and 5x10 , respec- 
tively. Finally, if the initial mixture consists of only the fuel and standard oxidant species (i.e., oxygen, nitro- 
gen, argon, and carbon dioxide, see table 8.1), the line following START must either be blank or contain the 
word END in columns 1 to 3. 

(9) Local Error Tolerances and Other Integration Controls (Namelist SOLVER) 

All controls for the LSODE package (refs. 20 to 22), which is used to solve the governing ordinary differ- 
ential equations, are read in from a namelist called SOLVER, which must follow the initial composition list. 

For a perfectly stirred reactor problem without a flow problem following it, this namelist is not required; howev- 
er, its inclusion will not cause an error exit. SOLVER contains variables that select the integration and correc- 
tor iteration methods. Local error tolerances and other control variables are also set here. The complete list of 
variables in SOLVER, with brief explanations, is as follows: 
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Variable 

name 

Variab 

type 

ATOLSP 

Real 

EMAX 

Real 

HINIT 

Real 

HMAX 

Real 

HMIN 

Real 

MAXORD 

Integer 

MAXSTP 

Integer 

MF 

Integer 

MXHNIL 

Integer 

MXSTEP 

Integer 


Explanation 

error tolerance for reacting species, default 

Local relative error tolerance for all variables; default 
value = 10° 

S t?n™ t0 !** attem P ted on toe first step; computed by 
LSODE, unless specified here 

Maximum step size allowed for problem; default value = «, 
Minimum step size allowed for problem; default value = 0 

tlT™ SIS '° U ” d by inK ^>»n defaul, 

^all™n000 mber ° f Stef>8 a,1 ° Wed f ° r the Pr ° blem; default 

Method flag; default value = 21 for “stiff” integrator 

Maximum number of messages printed per problem warning 
that step size is getting too small; default value =10 

Maximum number of (internally defined) steps allowed during 
one call to LSODE; default value = 500 “ 


tolerance for all vaLlea and TV* in S ° LVER ” EMAX ' ,he local ">'»«« 

The two variable, con «?££ 2^25 and “7 “ 7^7 f ° r mole number, 

for example, reference 38, which ^ *? “ ,*!*«- —My: see, 

value, for EMAX and ATOLSP favor accuracy over "* K Th * default 

Pure relative error control is obtained by setting ATOLSP - 0 0- FMAV !o * 
of accurate signficant figures in the numerical solution. Setting EMAY^nn 3 ° f the nUmber 

and ATOLSP is a measure of the largest number that mn v k g . _ 00 glVes pUre absolute error control 
problem the solution components vary widely in magnitude to" rei?^ N ° W ’ ^ 3 tyP ' Cal chemical reacti °n 
is not defined when one or more solution comnonenl ’ tlVe error contro1 is appropriate. However, it 
chemical kinetics problem several of the species have zero'! v"? S ° C3nn0t ** USCd ‘ (F ° r example ’ in a typical 
relative/absolute error control is used it LSENS and T COncentratio " s > Hence, mixed 

EMAX and ATOLSP. However, for a given EMAX 1?^ no ^ ero values mus t be specified for both 
relative error control for concentrations gZef^a t ^ AT ° LSP that produces mostly 

Such error control can be obtained by setting ATOLSP < n^FMAy’ t?.*"’ th3t ' S 001 Con8ide S ed significant. 
ATOLSP/EMAX provides th,s erro/c^f ft ^ f^‘f> nf ' **“*«*> (- * O' 9 ) for 

of order 0(100)). tractions > 0. 1 ppm (for a mixture with molecular weight 
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st be selected with care. 

the ATOLSP/EMAX ratio, the actual valu< 

In addition to the A f the local error, that , h rest to the user is th g Hed 5y the 

Near, ESODE con«ol an ^ ^ ^ th t » ^ - s ^ ^measumd no^co^ ^ ^ 

data regarded as exact. so i ulio n from the exact solu • eM aX an d ATOLSP- be neceS sary 

rr^'^ 

Cii. " In reducin8 the 

■ yoftheintegmmriathe 

tolerances both EM accuracy and efficiency The default 

method flag M nds to the stiff * g d lhe use of any othe '*5 a of ^ analytical Jacobian 

value (Mr - 1 > e we cannot recom lt8 and, in particular, nd efficiency are 

“u - — 

error and the ex pnnted and tn _ 20 is 

, fata1 . an error message win uc v The use of Mr - iu oi 

sas»»*iirr:»- s »=ss. 

Either difficulty may also be small, ^ SL’ LTstep length, that d>e 

&c=S;;=r,s;i=' 1 ““ 

The uaet may • - 

• hlea HINTT, HMAX, HM1N, and V ER solely for the convenience of 

The remaining vanablw. HTOTT. lsQDE . They are placed in SO 

tion controls, which are usualy V . aUy reference 22. 

users who are familiar with LSOE> , P* 5 indicating ^ be g in n.ng am 

to to specified for all variables, a dummy hne simp y 
If default values are to P 

ending of the nameha. may he uaed. 
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Qfll Sensitiviry a . 

COmPUM " ^ -CSS^ W tells the eo* wh , 

"> of dependent vatiah, ' ‘ °" “ " *» ^ « *» b. 

sensitivity coefficient, are re^° Whoae ini «ai value, 

® List of reaction numbere with _ 

-a^-ssSsSssr- 

ype (1) data must always h 

tyPM m * y “ ® lven in 4 o^?^ ^ one „ r boUl of 

^ Ch *w e * preceded by a kevwor^r (2) and W m*y be given - , 

1 *«^^>~ *"*•* 

"k r “ s^rr*"* - ^ 

"» apecie, '' ' '• 2I - »'• andT S "* "* •" ** *• 

reactions. To simn lifj & me must be given ThV • ’ To request sensitivity c~fr - he Variab 'e 

The names TEMp P DENsrrv ^ name ^TSP wi i, name must be written exact/ 6 "’ 8 f ° r an y rea «- 

p— % ^cS n ?rH PRESSURE -CT j“ v ^ of a " -Si Si: ,he 

( e -g., inert species m«i ^ dependent variable i;«t • r sens,t,v, ty coefficients nf mo e nu mbers. 

of this variabte wil^ C u UmbCrs) ’ its nam e will be del '" c,udes a variable that is con/ ™ perature > density 

HND i„ columns I to 3 “ <* names, A JiST 

T* ’ r" ,tiV ity coefficient, with 1,4? for aN v “™ble» a? ?? mm s P“ie,. Similatlv 

i^d- These data are identified^ ^ S ^ nsitlVlty coefficients with resp 

se pielist called SENRXN, whic^musTf ^ ntainin S the keyword REAcInTl 006 ^^ 6 " 1 param «er(s) are 
fr p : the rate coefficient parameters) wi ?°' V the ke y w °rd line. This namel/ 11 " 1 " 8 ’ f ° 4 ’ and fl re specified 
/e c ,h sensitivity analysis is to be performe/^?/ 0 Wh ' Ch sensit ivity coefficient 0 " 13 ’" 8 IOg ' Cal Var iables for 

mehSt Vanab,CS ^ “ f ° ,l0WS Whh ^nturTallo 
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Variable 

Variable 

Value 

Explanation 

name 

type 



ALLRXN 

Logical 

TRUE 

Sensitivities must be computed for all reactions Sensitivities are required 



FALSE 

for only reactions listed in RXNUM 

ORDER 

Logical 

TRUE 

Nonzero normalized sensitivity coefficients and reaction 
numbers are to be listed in decreasing order of importance 
for each rate coefficient parameter 



FALSE 

Reaction importance list is not required 

OUTPUT 

Logical 

TRUE 

Complete tables of normalized sensitivity coefficients are to 
be printed for each rate coefficient parameter 



FALSE 

Only reaction importance list is to be printed 

RXNUM 

Real 


Reaction numbers with respect to whose rate coefficient 
parameters) sensitivities are required; not needed if 
ALLRXN is set equal to TRUE 

SENSAJ 

Logical 

TRUE 

Sensitivities with respect to the rate coefficient parameter 
Aj are required 

Sensitivities with respect to Aj are not required 



FALSE 

SENSEJ 

Logical 

TRUE 

Sensitivities with respect to the rate coefficient parameter 
Ej (or Cj) are needed 

Sensitivities with respect to Ej (cj) are not needed 



FALSE 

SENSNJ 

Logical 

TRUE 

Sensitivities with respect to the rate coefficient parameter 
nj are required 



FALSE 

Sensitivities with respect to nj are not required 


For a nonconstant-temperature problem any of the logical variables SENSAJ, SENSNJ and SENSEJ may 
be set equal to TRUE. That is, sensitivity coefficients with respect to any of the rate coefficient parameters Aj, 
nj, and Ej or Cj can be computed. However, for a constant-temperature problem the normalized sensitivity coef- 
ficients with respect to all rate coefficient parameters are equal to one another (and equal to the normalized 
sensitivity coefficients with respect to the rate constant). Hence, sensitivity coefficients with respect to only Aj 
are produced, regardless of the rate coefficient parameters) specified. The reaction numbers for which sensitivi- 
ty coefficients are to be computed must be entered into the array, RXNUM. The logical variable ALLRXN 
may be set equal to TRUE and RXNUM omitted, if sensitivities are required for all reactions. 

As described in the next chapter, sensitivity coefficients with respect to rate coefficient parameters can be 
printed in two different ways, indexed by (a) reaction number and (b) by dependent variable, with the nonzero 
normalized sensitivity coefficients listed, along with the reaction numbers in decreasing order of importance. 
Type (a) output is the default format and can be switched off by setting the logical variable OUTPUT equal to 
FALSE. Type (b) output can be obtained by setting the logical variable ORDER equal to TRUE. If the user 
sets OUTPUT = FALSE but fails to set ORDER = TRUE, the code automatically performs the latter operation, 
so that some output is generated. 
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(in FINIS Line 

The last line of the Problem Data File must contain the word FINIS in columns 1 to 5 This line will 
follow the initial composition list or namelist SOLVER or the sensitivity analysis data, depending on the prob- 
lem type and whether the sensitivity analysis option is selected. 


Multiple Cases 

If several problems are to be solved during one run, the first case data must follow exactly the same format 
given above for a single case. For the second and subsequent cases the required data, which must be placed 
immediately after the first case data, depend on the information, if any, that can be used from the previous 
case(s). The code was designed to minimize the amount of input data, especially when they are the same for 
two or more consecutive cases. The data that are saved from any one case depend on the value assigned on the 
next case for an option called ACTION. The main purpose of providing this option was to eliminate typing in a 
reaction mechanism when it either is identical, or can be obtained by adding reactions, to that used on the previ- 
ous case. We now describe, in the order they must appear in the Problem Data File, the information that must 
be provided for each new problem. 

(1) Title Line 

The first line after the FINIS line for the previous case contains the title message described in the previous 
section (see item 1), and may be blank. 

(2) ACTION Line 

The next line of the data set must contain the value for the ACTION option that controls what data if any 
are saved from the previous case. The possible values are NEW, CHANGE, ADD, and 
REPEAT. One of the four words must be written on this line, starting in column 1. 

The word NEW tells the code not to save any data from the previous problem. This option should be used 
when the reaction mechanism is different from that previously read in, and cannot be constructed from it by 
adding reactions. In this case, all options and variables related to problem specification and control are 
reinitialized. The remainder of the problem data must be prepared using exactly the same format given in the 
previous section (see items 2 to 1 1) for a single case. 

If any other value (i.e., CHANGE, ADD or REPEAT) is assigned for ACTION, the reaction mechanism, 
rate coefficient parameters, third-body efficiencies, and inert species from the previous case are saved as are the 
options ACON, COMBUS, CONC, EXCHR, HTRAN, ORDER, OTTO, PCON, QMREAD, ROCKET 
RHOCON, SENCAL, SENSTD, SHOCK, TASS, TCON, WELSTR, WSFLOW, and WSRHTR. In addition, 
any of the following quantities that were required for the previous problem are saved: ATHROT BORE END 
HTO, HTI, HT2, HT3, HT4, IPRINT, PC, RPM, STROKE, TINY, TOTMAS, and TWALL; BETA D ETA 
LSUBM, and VISC; DELMD, DELT, DOTMAX, DTMAX, MPR, TMPMIN, VOLUME, WSRHTO, WSRHTI, 
WSRHT2, WSRHT3, and WSRHT4; profiles for assigned variable (pressure or area) and temperature; and the 
print station list. (It should be noted that if the user specifies a value for any variable not needed for the prob- 
lem, this information will not be saved.) 

None of the above quantities needs to be reset, unless either a new value is required or a different option 
selected. In the latter case, the previously specified option must be switched off. For example, if the previous 
problem required the computation of heat transfer rates and so HTRAN had been set equal to TRUE in PROB, 
and the present case is adiabatic, HTRAN must now be set equal to FALSE in PROB. Similarly, if a different 
heat transfer model is to be used, the variable QMREAD must be reset accordingly, and the data required by the 
new model supplied. Another illustrative example is as follows. Suppose the previous case had involved a 
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perfectly stirred reactor problem followed by a plug flow problem, and so the variable WSFLOW (and maybe, 
WELSTR) had been set equal to TRUE in PROB. If the present case does not require a flow problem calcula- 
tion, WSFLOW must be set equal to FALSE in PROB, but WELSTR need not be given. Of course, if a totally 
different problem type is to be considered, both WELSTR and WSFLOW must be set equal to FALSE, and the 
appropriate option switch supplied. 

If a different problem type is specified, any option selected previously that might either be in conflict with, 
or is not allowed by, the new problem must be switched off: otherwise, an error exit will occur. An example is 
sensitivity analysis, which can be performed only for a static problem. Thus, if a static problem for which 
sensitivity analysis had been selected by setting SENCAL equal to TRUE in PROB is followed by a flow prob- 
lem, SENCAL must be set equal to FALSE in PROB. 

The CHANGE option allows the user to change any rate coefficient parameter and/or third-body efficiency 
for any reaction previously given. This option may also be used to change the reversibility of a reaction and/or 
the form of the rate coefficient expression. In any case, the reactions whose parameters are to be modified must 
be listed, one per line, immediately after the ACTION line. Each reaction must be given exactly as before, 
using the format given in the previous section (see item 2). In addition, values must be specified for all three 
rate coefficient parameters, even those with the same values. 

If collisional efficiencies are to be changed for a third-body collisional reaction, lines containing the word 
THIRDBODY and the species names and efficiencies must follow the reaction, as described in the previous 
section (item 2). Only species whose efficiences are different from those previously specified need to be listed. 
Note that the input data must contain any species whose new, but not old, efficiency is unity. Such species will 
be deleted from the third-body list. Similarly, the list will be expanded to include every species whose efficien- 
cy is changed from unity. Such species and their new efficiencies must be included in the problem data. Final- 
ly, a new species, that is, one that was not considered for the previous problem, can be included in the third- 
body list, by taking the following actions. The new species and its third-body efficiency are given, as discussed 
above. The ADD option, described below, is later used to add the new species to the species list, by means of 
either new reaction(s) for a reacting species or the inert species list. 

However the CHANGE option is used, the end of the reaction list is indicated by a line that either is blank 
or contains the word END in the first reactant field (i.e., columns 4 to 7). The reaction list must be followed by 
another ACTION line, which must contain either the word ADD or REPEAT, starting in column 1. 

The ADD option enables the user to add new reactions to the previous mechanism and thus, possibly new 
reacting species. If this option is used, the value of the logical variable RXNTST from the previous case is also 
saved. The new reactions are entered, one per line, immediately following the ACTION line. The information 
required on each reaction line and its format are identical to those described in the previous section (see item 2). 
The end of the new reaction list is signaled by a line that either contains the word END in columns 4 to 7 or is 
blank. 

Provision has also been made to add new inert species to the mixture. After the reaction list, the next line 
or lines must contain the new inert species, using the same format as for the first case (see item 3 in the previ- 
ous section). Species declared inert in the previous case(s) need not be listed. The end of the inert species list 
is indicated by a species field that either is blank or contains the word END in the first three columns. If no 
new inert species is to be considered, the reaction list must be followed by a line that either contains the word 
END in columns 1 to 3 or is blank. 
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The ADD option can be used to only add new inert species. In this case, the ACTION line must be fol- 
lowed by a blank line or one containing the word END in columns 4 to 7. The new inert species list is then 
entered, as described above. 

The REPEAT option tells the code to use exactly the same reaction mechanism specified previously. In 
addition, the list of reacting and inert species is unchanged. However, some reaction information may have 
been changed by means of the CHANGE option. 

The following information must follow either the REPEAT line or, if the ADD option has been used, the 
inert species list. 

(3) Integr ation and Assigned Variables. Units and Fuel Name Line 

None of this information is saved from the previous case, so the next line of the Problem Data File must 
list the integration and assigned variables, input and output units and, possibly the fuel name. The format is 
identical to that used for the first case (see item 4 in the previous section). 

(4) Problem Data, Related Options. Heat Transfer Data, and Output Controls 

The variables specifying the problem type and options, that is, namelist PROB, must be supplied next. 

(The variables and options that are set in this namelist are described in item 6 of the previous section). As 
discussed above, previously selected options that are not required or cannot be used must be switched off, and 
those needed for the new case must be switched on. In addition, new variables required for the problem, or 
previously specified variables with new values, must be set. However, previously specified variables not needed 

for this case do not have to be listed. The same rule applies to previously specified variables with the same 
values as before. 

If no new option or variable is required and the previously assigned variables need not be changed, a dum- 
my line simply indicating the beginning and ending of the namelist may be inserted. It must be remembered 
that variables which are both required by and introduced into a NEW and then successive REPEAT (or ADD) 
cases are saved until overwritten by the new user-supplied values. Thus, until the NEW option is again select- 
ed, the user has access to the most recently specified value for every quantity that is saved (see above for list). 

(5) Assigned Temperature Profile 

If the temperature is assigned the namelist TMPDAT, described in the previous section (see item 6), must 
follow PROB. The variables that must be set in TMPDAT depend on the options and variables, if any, previ- 
ously assigned in this namelist. If this is the first assigned temperature problem since the last NEW option was 
selected, TMPDAT must contain the variables described in the previous section. However, if the temperature 
had been assigned previously, only new options, new variables and variables with new values need to be listed. 
If no new option or variable is required and the previously assigned variables need not be changed, a dummy 
line simply indicating the beginning and ending of the namelist may be entered. 

(6) Perfectly Stirred Reactor Problem Data 

If a PSR calculation is required the namelist WSPROB, described in the previous section (see item 7) 
must follow PROB. The variables that must be set in WSPROB depend on the options and variables, if any 
previously assigned in this namelist. If this is the first PSR problem since the last NEW option was selected, 
WSPROB must contain the variables described in the previous section. However, if a PSR problem had been 
specified previously, only new options, new variables and variables with new values need to be listed. If no 
new option or variable is required and the previously assigned variables need not be changed, a dummy line 
simply indicating the beginning and ending of the namelist may be inserted. 



(7) Initial Conditions 

The initial values of thermodynamic and fluid dynamic variables must be given in namelist START, which 
must follow PROB, TMPDAT, or WSPROB. No initial condition is saved, so the user must supply all the 
required input data, which depend on the problem type, as discussed in the previous section (see item 8). The 
namelist must be followed by the initial mixture composition list, as described previously. 

(8) Local Error Tolerances and Other Integration Controls 

Following the initial composition list, the integration controls are given in namelist SOLVER, if necessary, 
as explained in the previous section (see item 9). If this is the first problem for which SOLVER is either re- 
quired or given since the last NEW option was selected, the namelist must contain variables for which 
nondefault values are to be used. However, if integration controls had been assigned previously, only new 
variables and variables with new values need to be set. If the previously assigned variables, default or other- 
wise, need not be changed and no new variable is required, a dummy line simply indicating the beginning and 
ending of the namelist may be given. 

(9) Sensitivity Analysis Data 

If sensitivity analysis is required for this case, all of the data described in the previous section (see item 
10) must follow SOLVER, because none of this information is saved. 

(10) FINIS Line 

The input data must end with a line containing the word FINIS in columns 1 to 5. 
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CHAPTER 12 - DESCRIPTION OF OUTPUT 


For all problem types the input information is printed in two ways. First, an exact image of the Problem 
Data File, except any thermodynamic coefficients included here, is produced for each case. Blank lines in the 
input file are identified by the words “BLANK LINE”. To assist the user in checking input data for errors the 
code prints column numbers from 1 to 80 at the top of this image. 

Second, more detailed input information, including problem type and options selected, is printed, usually in 
the output units specified by the user. This material is given in the following order. 

(1) Lists of elements and reacting and inert species considered for the problem are generated, as are the 
thermodynamic data, molar mass, heat of formation (in cal/mol) at 25 °C, and, if required for the problem, 
transport data for each species. 

(2) If an equilibrium or shock calculation is performed the results are printed in the format described below 
in the section “Equilibrium and Shock Calculations”. 

(3) The reaction mechanism and forward rate coefficient parameters, third body efficiencies and input and 
output units are printed. 


(4) For a perfectly stirred reactor (PSR) problem the reactor volume, mass flow rate either for the first 
solution or to start the iteration for an assigned temperature problem, the problem type, and the input data re- 
quired for the calculation are given. For all other problem types the assigned variable and temperature profiles, 
number of ordinary differential equations (ODEs) required, integration controls, sensitivity analysis data, includ- 
ing the normalization factor(s) for any rate coefficient parameter(s) selected, and output control information are 
printed. 

(5) The above information is followed by the heat transfer data if any, simplified composition input data if 
this option is selected and numbers of reacting and inert species. 


(6) The initial values of many variables and their derivatives, described below in the section “Static and 
Flow Kinetics Problems”, are then listed. 

(7) Finally, the CPU time required so far, that is, to initialize the code, is given in seconds. 

The output information related to problem solution depends on the problem type and options selected. For 
each problem type certain standard material is automatically generated at each print station. For static and flow 
kinetics and PSR problems optional output may be obtained, either in place of some standard quantities or in 
addition to regular output. If the sensitivity analysis option is selected, additional variables are printed. We 
now discuss the solution information that is generated for each problem type and related option. 


Static and Flow Kinetics Problems 

For a static or one-dimensional flow problem, including that following either an incident shock or a PSR 

computation, the following standard information is listed if no option related to output information specification 
is selected in namelist PROB: 

(1) Reaction time, t (gas-particle time for shock reaction); flow cross sectional area, A (for shock reaction, 
normalized area A/A^, where A s is the shock-tube cross-sectional area); and axial position, x. 



(2) Pressure, p; velocity, V; density, p; temperature, T; and mass flow rate, rti (mass flow rate per unit 
cross-sectional area, i.e., mass flux rh", for shock reaction). 


(3) The thermodynamic and fluid mechanic properties 


(a) Mass-specific entropy, s, given by 


s 


NS 



5 i 

R 


\ 

- In o i - In (pM w ) . 

/ 


( 12 . 1 ) 


where R is the universal gas constant, NS is the total number of (reacting and inert) species, cf^ is the mole 
number of species i (i.e., moles of species i per unit mass of mixture), s° is the standard-state, i.e., 1 atm, 
molar-specific entropy of species i, and IV^ is the mixture molar mass: 


M 


w 


1 

NS” 


E * 


(12.2) 


(b) Mach number, M: 


M 


y/y(R/M w )T 


where y is the (frozen) specific heat ratio of the mixture 


(12.3) 



and c^ the mixture mass-specific heat at constant- pressure, is given by 

NS 

C p ** 5 ^ 

i*l 


(12.4) 


(12.5) 


where c p j is the constant-pressure molar-specific heat of species i. 

(c) Specific heat ratio, y, equation (12.4). 

(d) Mixture mass-specific enthalpy, h, equation (8.36). 

(e) Constant-pressure specific heat of the mixture, c p , equation ( 12.5). 

(4) For a problem with heat transfer, heat transfer rate per unit mass of mixture, Q/m, for a static problem 
or heat transfer per unit mass of mixture per unit length in direction of flow, Q'/rh, for a flow problem. 
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(5) Integration indicators 


(a) Number of integration steps from last print, INST. 

(b) Average step size since last print, AVH. 

(c) Order of the integration method used on the last step, NQ. 

(d) Total number of integration steps, NSTEP. 

(e) Total number of derivative function evaluations, NFE. 


(f) Total number of Jacobian matrix evaluations, NJE. This number is equal to the total number of 
LU-decompositions of the iteration matrix. 

(6) For each species i 

(a) Molar concentration, Cj, 


C i = P a i- (12.6) 

(b) Mole fraction, x^, 


x i = CT i M w (12.7) 

(c) Net species production rate per unit volume, 


NR 

= £ Wjj, (12.8) 

j=i 

where NR is the total number of reactions and Wy, the net molar formation rate of species i per unit volume 
by reaction j, is given by equation (8.58). W { is the net formation rate of species i per unit volume due to 
all reactions and is negative if the species is being destroyed. 

(7) For each reaction j, the rate coefficient value kj, equation (8.3) or (8.4); the net reaction conversion 
rate X jf equation (8.56); and the equilibration factor E q , equation (8.61). For a third-body collisional reaction, 
the kj printed is for the reference rate coefficient formula. 

(8) Derivatives of temperature, density and, for a flow problem, velocity with respect to the integration 
variable. 

(9) Mixture molar mass, M w , equation ( 12.2). 

( 10) Total energy exchange rate, X H , 
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(12.9) 


NR 

x„ = E x j 

j-i 



where (AH-^gJj is the standard-state enthalpy change for the jth reaction at a temperature of 298 K: 



v ij 'A i °(298 K), 


( 12 . 10 ) 


where v-' and v-" are, respectively, the stoichiometric coefficients of reactant species i and product species 
i in reaction j, A°( 298 K) is the standard-state molar-specific enthalpy of species i at 298 K. The quantity 
X H is proportional to the net heat release rate for the entire complex reaction and may be useful in studying 
ignition processes. 

(II) Mass fraction sum, S m : 


NS 

= E 

i=l 


a i^w,i’ 


( 12 . 11 ) 


where j is the molar mass of species i. If, at any time, S m is not close to unity, we have found that 
continued integration sometimes produces significantly inaccurate results. Therefore, if S m is different from 
unity by more than 5xl0 5 , an error exit is taken. This error exit means one or more of the following: (a) the 
integration method is inappropriate, (b) the local error tolerances must be reduced and (c) the reaction mecha- 
nism contains one or more reactions that do not satisfy atom and/or charge balance requirements. 

(12) The CPU time in seconds used both since last output, ICPU, and so far for the problem, CPU. 

For each dimensional quantity listed above, except the average step size which has the same units as the 
integration variable and the CPU time which is always given in seconds, we list in table 12.1 the units used on 
output for each of the three systems of units included in the code. In this table, £ is the integration variable, 
time or distance. 


After successful completion of the problem, the following summary of the computational work required to 
solve the problem is printed: total number of integration steps, total number of derivative evaluations, total 
number of Jacobian matrix evaluations and LU-decompositions of the iteration matrix, and total execution time 
in seconds. In addition, the total CPU time (TCPU) required for code initialization, input, processing of input 
and output data, problem solution, and output, is given in seconds. 


Optional Output . - The optional output, if any, that is produced depends on the output information specifi- 
cation options selected in namelist PROB (see table 1 1.4 and item 5 in the section “Problem Data File for Sin- 
gle Case” of chapter 11). In particular, setting nondefault values for the logical variables CONC, DBUGO, 
EXCHR, ORDER, and ROCKET produces the following information: 
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TABLE 12.1. - UNITS FOR OUTPUT VARIABLES IN THE THREE SYSTEMS 

ALLOWED BY THE CODE 


Variable 

Units 

cgs 

(internal) 

U.S. 

customary 

SI 

Time 

s 

s 

s 

Area 

2 

cm 

ft 2 

m 2 

Axial position 

cm 

ft 

m 

Pressure 

atm 

Ibf/fit 2 

N/m 2 

Velocity 

cm/s 

ft/s 

m/s 

Density 

g/cm 3 

lb/ft 3 

kg/m 3 

Temperature 

K 

°R 

K 

Mass flow rate 

g/s 

Ib/s 

kg/s 

Mass flux 

g/s/cm 2 

lb/s/ft 2 

kg/s/m 2 

Specific entropy 

cal/g/K 

Btu/lb/°R 

J/kg/K 

Specific enthalpy 

cal/g 

Btu/lb 

J/kg 

Constant-pressure specific heat 

cal/g/K 

Btu/lb/°R 

J/kg/K 

Heat loss term, Q/m 

cal/s/g 

Btu/s/lb 

J/s/kg 

Q’/m 

cal/g/cm 

Btu/lb/ft 

J/kg/m 

Species molar concentration 

mole/cm 3 

lb mole/ft 3 

kmole/m 

Species production rate 

mole/cm 3 /s 

lb mole/ft 3 /s 

kmole/m 3 /s 

Reaction rate coefficient 

cgs units* 

cgs units* 

cgs units* 

Net reaction conversion rate 

mole/cm 3 /s/p 2 

lb mole/frVs/p 2 

kmole/m /s/p 

Temperature derivative dT/d? 

K/unit ? 

°R/unit ? 

K/unit ? 

Density derivative dp/d? 

g/cm 3 /unit ? 

Ib/ft 3 /unit ? 

-i v 

kg/m /unit ? 

Velocity derivative dV/d? 

cm/s/unit ? 

ft/s/unit ? 

m/s/unit ? 

Mixture molar mass 

g/mole 

lb/lb mole 

kg/kmole 

Net energy exchange rate 

cal/cm 3 /s/p 2 

Btu/ftVs/p 2 

J/m 3 /s/p 2 


a Units for first-order reaction are s'*. 

Units for bimolecular reaction are cm 3 mole' 1 s' 1 . 
Units for termolecular reaction are cm 6 mole' 2 s' 1 . 


(1) Species mass fractions, {yj, where 


y. = (12.12) 

are listed in place of molar concentrations, {C,}, equation (12.6), if CONC is set equal to FALSE. 

(2) A complete listing of the {<?;}, derivatives of {o^} with respect to the integration variable and {to } 

equation (8.58), are provided if DBUGO is set equal to TRUE. The above information is useful for debugging 
and is always given in cgs units. ' & 

(3) Setting EXCHR equal to TRUE will produce the net energy exchange rates, {Xpjj}, 




(12.13) 



instead of the {Xj}, equation (8.56). 

(4) An ordered list of nonzero net formation rates, {tOjj} (in moles/cm 3 s), equation (8.58), is printed for 
each species i and each reaction j, if ORDER is set equal to TRUE. 

(5) For a flow problem, if rocket performance parameters are required, that is, if ROCKET is set equal to 
TRUE, the following variables are tabulated: 

(a) Specific impulse, I sp : 


i -JL 

* 8c 


(12.14) 


(b) Vacuum specific impulse, I vac : 


^vac ^sp 


+ P* 


(12.15) 


m 


(c) Area ratio, A^ 


A 

' \ 


(12.16) 


(d) Characteristic velocity, c*: 


♦ Pc A t8c 
c 


(12.17) 


m 


(e) Thrust coefficient, c^: 


c f = 


(12.18) 


In the above equations, g c is a units conversion factor, \ is the nozzle throat area and p c is the rocket 
combustion chamber pressure. Irrespective of the output units selected by the user, X sp and I vac are given in 
both SI and U.S. customary units and c* is printed in ft/s. 


Sensitivity Analysis 

Two different formats, one default and the other optional, are available for printing the normalized sensitiv- 
ity coefficients with respect to rate coefficient parameters. The formats are selected by means of the logical 
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vanables OUTPUT and ORDER, as described in item 10 in the section “Problem Data File for Single Case” of 
chapter 1 1. The default output control, corresponding to OUTPUT = TRUE, produces a table of all normalized 
sensiuvrty coefficients {<S ij >}, including those set equal to zero because their magnitudes are smaller than 
(3ee ltem 5 ,n the sect ‘on “Problem Data File for Single Case” of chapter II). The first column of this 

K T° n < n r mberS ’ Whkh 3re liSted either in the order as specified in the array 
KXNUM or serially, if ALLRXN has been set equal to TRUE (see item 10 in the section “Problem Data File 

OF f k 8 6 C ? Se u ° f cha P ter 1 1) - The ^pendent variable names are printed in the first row. The species if any 
are tabulated I m the order that they appear in either (a) the list of dependent variable names or (b) the reaction 
mechanism, jf either keyword ALLSP or ALL has been used (see item 10 in the section “Problem Data File for 
Single Case of chapter 11). They are followed by any nonconstant-variable(s), temperature, density and pres- 
sure. long every subsequent row, the reaction number and normalized sensitivity coefficients of the appropri- 
ate dependent variables with respect to the relevant rate coefficient parameter are listed. 

f A , ^ 'It USer S ° P | tl0 ?’, 3 dlf J erently indexed tabIe is produced, either in addition to, or in place of, the default 

format. The optional table, selected by setting ORDER equal to TRUE, is indexed by dependent variable 
names, reaction numbers and normalized sensitivity coefficients along the rows. The order used for the names 
is the same as that described above for the default format. For each dependent variable the reaction numbers 
are listed m order of decreasing importance, that is, decreasing magnitude of the {<S U >}. The normalized sen- 
sitivity coefficient of the dependent variable listed in the first column with respect to the appropriate rate coeffi- 
cient parameter is placed directly under the reaction number. Neither the {<S if >} that have been set equal to 
zero nor the corresponding reaction numbers are printed. 

For both output formats a separate table is produced for each rate coefficient parameter selected by the 

user. The reaction time, rate coefficient parameter name and the procedure used to normalize the results with 
respect to that parameter are given. 

For initial condition sensitivities, only the default format is used. The first column of the table gives the 
names of the independent variables, that is, the initial conditions for which sensitivities are computed The 
dependent variables are listed along the first row. The order used for both quantities is exactly the same as that 
described earlier for the dependent vanables. The second and subsequent rows contain the appropriate {<S >}. 
ror these sensivities also, the normalization procedures are given. 

If sensitivity coefficients of the temporal derivatives, {<^>1, are computed, exactly the same output for- 
mats described above are used. f„ this case also, the normalization procedure, are printed for both initial condi- 
tion and rate coefficient parameter sensitivities. 

After successful completion of the problem, summary information regarding the computational work re- 

rorl'T n * f giVen ' In P ar,icular - *• Mowing quantities are printed: total number of steps, 
total number of dertvative evaluation, and total number of Jacobian matrix evaluation, and LU-decomposition, 

of the iteration matrix. Finally, the dimensions of the real and integer work anay, (i.e„ total storage) used for 
integrating the kinetics and sensitivity ODEs are listed. 6 


Equilibrium and Shock Calculations 

The output format is the same for the three problem types, chemical equilibrium, equilibrium shock and 

rozen s oc . irst, initial and final values and the ratio of final to initial state values are listed for each of the 
following variables: 

(I) Pressure, p. 
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(2) Gas velocity, V. 


(3) Density, p. 

(4) Temperature, T. 

(5) Mixture mass-specific enthalpy, h, equation (8.36). 

(6) Mixture mass-specific internal energy, u, 

u = h - RT/M W . (12.19) 

(7) Constant-pressure specific heat of the mixture, (dh/dT) p , which reduces to equation (12.5) for both 
initial states and the final state of the frozen shock computations. 

(8) Mixture mass-specific entropy, s, equation (12.1). 

(9) Mach number, M, given by 

M - V/c, (12.20) 

where the sonic velocity, c, is computed as follows: 


C “ 

GAMMA 

\ 

R 

\ 


r*J 


( 12 . 21 ) 


where GAMMA depends on the problem type and the state, i.e., initial or final. For both equilibrium problems 
the final state GAMMA is given by 


GAMMA * 



(12.22) 


where v is the mixture specific volume. For all initial states and the final frozen shock state GAMMA reduces 
to the specific heat ratio, y, equation (12.4). 


( 10) The quantity GAMMA defined above in equation ( 12.22). 

(11) The sonic velocity, c, equation (12.21). 

The initial and final velocities and Mach numbers are zero for a chemical equilibrium problem. For both 
variables the ratios of final to initial values are set equal to unity. 

The above list of variables is followed by the final state mixture composition, expressed as mole fractions, 
|xj, equation (12.7). The following final state thermodynamic properties are then printed: mixture molar 
mass, M w , equation (12.2), and the derivatives (din v/dln T) and (din v/dln p)j. (For the frozen shock problem 
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(din v/dln T) p = 1 and (din v/dln p>j- = -1.) 

Finally a summary of the computational work required to solve the problem is listed. The quantities print 
ed include the total number of iterations, NITER, and the execution time, CPU, in seconds. 


Perfectly Stirred Reactor Problem 


For an assigned mass flow rate or temperature problem the following standard information is listed First 
the results of the equilibrium computation are printed using exactly the same format as that given above for a ’ 
kinetics problem in the section “Static and Flow Kinetics Problems”. This information is followed by a summa 

ry o the computational work required for the equilibrium calculation and the initial estimates for temperature 
and species mole numbers, {aj. 


For both problem types the following quantities are listed after the first successful convergence: 

1 ( * ) J Initial and prCSent ValU6S ° f P re8SUre ’ P» temperature, T, mixture mass-specific entropy, s, equation 
(12.1), density, p, mixture mass-specific enthalpy, h, equation (8.36), constant-pressure mass-specific heat, c 
equation (12.5), molar mass, M*,, equation (12.2), and specific heat ratio, y, equation (12.4). Ratios of present 
to initial values are also given for each variable. 


, ' 2) “ d presen,v ‘ l 1 lues of bo,h -"O'* <W> -ass (M) fractions of each species, equations 
(12.7) and (12.12), respectively. 

(3) For a problem with heat transfer, the heat loss term Q/m, where Q is the heat loss rate and m the 
mass flow rate. 


(4) The reactor volume, V, and mass flow rate. 


(5) The ratio m JV, the reactor 
convergence, NITER. 


average residence time, t r (= pV/m), and the number of iterations needed for 


The above information is also printed after every MPR (see item 7 in the section “Problem Data File for 
Single Case of chapter 1 1) successful convergences and, irrespective of MPR, after the last successful conver- 
gence for the problem, that is, the one at the desired exit conditions. After the last convergence, the total num 
ber of iterations and the execution time in seconds required for the PSR calculation are given. If output is not 
required after any given convergence, the following quantities are printed: the convergence number, NCONV 
number of iterations, mass flow rate, temperature, and residence time. 


Optional Additional Output . -The additional output, if any, that is produced depends on the values assigned 
for the logical variables DBUGO in namelist PROB and RITE in namelist WSPROB (see items 5 and 7 in The 
section “Problem Data File for Single Case” of chapter 11). If debug output information has been asked for, 
t at is, DBUGO has been set equal to TRUE, the following variables are given on each iteration: iteration 
number, ITER; temperature; mass flow rate; net species production rate per unit volume, {W }, equation (12.8V 
the Newton-Raphson functionals, {TZ(I)}; the sum of the squares of the {TZ(I)}, FSUM; the FSUM value from 
the previous iteration, PFSUM (for the first iteration PFSUM is assigned a value of zero); either the log correc- 
tion Ain T for an assigned mass flow rate problem or Ain m for an assigned temperature problem; and the 
sum of the species mole numbers, o m , 
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(12.23) 


NS 

CT m = E 

i=l 

The above list is followed by the species mole numbers, {aj, and their log corrections, {Ain a,}; the 
underrelaxation factors, LAMBDA and LAMBDA 1, used to control the corrections; and the mass frac- 
tion sum, S m , equation (12.11). 

If reaction rate information is required, that is, RITE has been set equal to TRUE, the following quantities 
are printed on every iteration: net reaction rates per unit volume, {ij}, equation (8.57), and the species net 
molar formation rates per unit volume due to each reaction, {tOjj}, equation (8.58). 

Irrespective of the output units selected by the user, the two types of information described above are given 
in cgs units. In addition, they are both generated if any PSR calculation is abandoned because successful con- 
vergence could not be achieved after 75 iterations. 

Summary of Output Information 

For the user’s convenience the output information given above is summarized in table 12.2 for each prob- 
lem type and option included in the code. 


Ill 


TABLE 12.2. - SUMMARY OF OUTPUT 


Problem type 
or option 

Information 

type: 

standard or 
optional 

Keyword and value 
required to either 
switch off standard 
output or switch on 
optional output 

Namelist 

where 

keyword 

appears 

Variables printed a 

Kinetics-only 
(static or 
1-D flow 
reaction) 

Standard 



t, A or A/A s; x, p, V, p, T, m or m", s, 
M, y, h, 0 ^ Q/m or Q'/m, INST, AVH, 
NQ, NSTEP, NFE, NJE, {q}, { Xj }, 
W* { k j}- {Xj}, {E dT/d?, dp/d?, 

dV/d?, M w> X H , S m , ICPU, and CPU. 
At problem end: NSTEP, NFE, NJE, 
CPU, and TCPU. 

Optional 

CONC=.FALSE. 

EXCHR=.TRUE. 

ORDER=.TRUE. b 

DBUGO=.TRUE. b 

ROCKET=.TRUE. c 

PROB 

PROB 

PROB 

PROB 

PROB 

{y ; } in place of {q} 

{X HJ } in place of {Xj} 

Nonzero {Wy} listed in decreasing 
magnitude, along with corresponding 
reaction number j, for each species i 
{a,}, {d<yd?}, { Wij }. 

Pc’ ®sp’ ^vac’ A/A t . 

Kinetics and 
sensitivity 
analysis 
(static 
reaction 
only) d 

Standard 

Standard 

OUTPUT =.FALSE. 

1 | 

SENRXN 

{<Sjj>} with respect to initial condition 
values, indexed by variable name. 
{ <s ij > } with respect to rate coefficient 
parameters, indexed by reaction number. 

Optional 

TINY > 0.0 

SENSTD=.TRUE. 

ORDER=.TRUE. 

PROB 

PROB 

SENRXN 

If |<S j :> | < TINY, set <Sjj> = 0.0. If 
{ < S i j>} required (see below), same rule 
applies. 

{ < S i j > }, indexed by initial condition 
name and, if OUTPUT=. TRUE., by 
reaction number. 

Nonzero {<Sjj>} and, if required, 
{ < S i j > }, with respect to rate coefficient 
parameters, listed in decreasing magni- 
tude, along with corresponding reaction 
numbers. 

Chemical 
equilibrium, 
equilibrium 
shock and 
frozen shock 

Standard 



Initial and final state values and ratios 
of the latter to former of: p, V, p, T, h, 
u, (dh/OT) p , s, M y GAMMA, c. Final 
state values of {xj, M w , (din v/dln T) 
(din v/dln p>p NITER, CPU. P 







Perfectly 

stirred 

reactor 

Standard 3 



Results of equilibrium calculation, in 
format given above for kinetics-only 
problem, NITER and CPU required for 
this computation and initial estimates 
for T and {oj}. After the first, then 
every MPRth e and final, successful con- 
vergences: initial and present values 
and ratios of latter to former of p, T, s, 
p, h, and c ; initial and present values 
of y, {Xj}, and {yj; Q/m, V, m, 

rh IV y T f , and NITER. After conver- 
gences for which detailed output not 
required: NCONV, NITER, m, T, and 
x r . At end of problem: computational 
work for PSR computation. 

Optional 

RITE=.TRUE. bf 

DBUGO=.TRUE. bf 

WSPROB 

PROB 

After every iteration: {n} and {toy}. 
After every iteration: ITER, T, m, 
{Wj}, {TZ(I)}, FSUM, PFSUM, Ain T 
or Ain m, o m , {Oj}, {Ain o^, 
LAMBDA, LAMBDA 1, S m . 


a Except where indicated, output can be obtained in one of the following three systems of units: cgs (default), 
U.S. customary and SI. All CPU rimes are given in s. 
hrhis information is given in cgs units. 

c The quantities p c , A t and c* are given in U.S. customary units and Ij p and Iy ac in both SI and U.S. 
customary units. 

d The information listed for a kinetics-only problem are also generated at every print station. At end of problem, 
NSTEP, NFE and NJE required for sensitivity computations and the required lengths of the arrays RWORK and 
IWORK are printed. 

e The integer variable MPR (default value = 1) is set in namelist WSPROB. 

f These variables are also printed if any PSR calculation is abandoned because successful convergence could not 
be achieved in 75 iterations. 


113 










CHAPTER 13 - EXAMPLES OF CODE USAGE 

In this chapter we illustrate Problem Data File preparation by means of two kinetics-only test cases and one 
k i net ic9-p lus-sensitiv ity analysis problem. In addition, we examine the effects of local error tolerance parame- 
ters on the accuracy of the solutions and computational work for both types of calculation. The information will 
help the user select error parameters which give the desired compromise between accuracy and computational 
speed. All results presented in this chapter were generated on the NASA Lewis Research Center’s Amdahl 

5870 computer using the UTS operating system, the Fujitsu 77 compiler (optimization level = 3) and double- 
precision accuracy. 


Kinetics Test Cases 

P ropane-Air Perfectly Stirred Reactor-pl u s-Plug Flow Problem . - The first test case involves a perfectly 
stirred reactor (PSR) problem followed by a flow problem. The task is to perform an assigned mass flow rate 
PSR computation for a fuel-rich (fuel-air equivalence ratio 4> » 2) propane-air mixture. The air consists of a 
mixture of oxygen, nitrogen, argon and carbon dioxide. The chemical mechanism involves 42 species and 136 
reactions. Thermodynamic data for all species are to be taken from the Standard Thermodynamic Data File. 

The code will be required to check the validity of the reaction mechanism because of its relatively large size. 

The reactor volume is 300 cm 3 . The mass flow rate, pressure and inlet temperature are 1600 g/s, 5 atm. 
and 614 K, respectively. The inlet composition will be specified by mass fractions. The reactor is not adiabatic 
and the heat loss rate, Q (in cal/s) is given by 


0 = -42.88 + 0.05 T, (131 

where T is the temperature in K. 

The exit gas from the PSR will be expanded through a diverging 4-cm long nozzle whose area profile is as 
follows: 


A = 15 + 20x, (13.2) 

where A is the area in cm 2 and x is the distance in cm. The throat is assumed to be at x = 0.0 cm and 
therefore has a cross-sectional area of 15 cm 2 (2.325 in 2 ). The integration variable for the flow problem is 
distance. This problem is also nonadiabatic and the heat transfer rate is to be computed by using the built-in 
correlations and a nozzle wall temperature of 700 K. 

Computed results, including rocket performance parameters, are to be printed in cgs units at x = 0.4, 2 and 
4 cm. To make sure that the expansion computation is not started when the Mach number is too close to’unity, 
an initial value of x = 0.2 cm will be used. However, the initial reaction time is zero. Mass fractions are to 
be used for printing concentrations at the output stations. 

Problem Data File . - Table 13.1 lists the required Problem Data File, which is now described. 

X hermodynamic and reaction mechanism data . - Since this test case obtains all thermodynamic data from 
the Standard Thermodynamic Data File the first line of the Problem Data File has the word TAPE starting in 
column 1. The next line of the file contains an identifying title. It is followed by the reaction mechanism. The 
hydrogen-oxygen mechanism is the most recent version of the scheme developed by Brabbs and Musiak 
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TABLE 13.1. 


PROBLEM DATA FILE FOR PROPANE- AIR PSR - PLUS - FLOW TEST CASE 


TAPE 


LSENS 

PROPANE -AIR 

WELL -STIRRED 

CH3 

+ 

C3H8 

C3H8 

= C2H5 

= CH4 

M 

+ 

C3H7 

CH4 

= C2H4 

= CH3 

H 

+ 

CH4 

= CH3 

CH4 

+ 

02 

= CH3 

O 

+ 

CH4 

= CH3 

OH 

+ 

CH4 

= CH3 

CH3 

+ 

02 

= CH30 

CH3 

+ 

OH 

= CH30 

M 

+ 

CH30 

= CH 20 

CH3 

+ 

CH3 

= C2H6 

H 

+ 

C2H6 

= C2H5 

O 

+ 

C2H6 

= C2H5 

OH 

+ 

C2H6 

= C2H5 

M 

+ 

C2H5 

= C2H4 

C2H5 

+ 

02 

= C2H4 

H 

+ 

C2H5 

= C2H4 

CH3 

+ 

CH2 

= C2H4 

H 

+ 

C2H4 

= H2 

M 

+ 

C2H4 

= C2H2 

C2H4 

+ 

OH 

= C2H3 

C2H4 

+ 

OH 

= CH3 

C2H4 

+ 

O 

= CH3 

C2H4 

+ 

O 

= CH20 

M 

+ 

C2H3 

- C2H2 

C2H3 

+ 

02 

= CH20 

C2H3 

+ 

H 

= C2H2 

C2H3 

+ 

O 

= C2H20 

C2H3 

+ 

OH 

= C2H2 

C2H3 

+• 

CH2 

= C2H2 

C2H3 

-t- 

C2H 

-2 . 0C2H2 

M 

+ 

C2H2 

= C2H 

C2H2 

+ 

O 

= CH2 

C2H2 

+ 

O 

= C2HO 

C2H2 

+ 

OH 

*= C2H 

C2H2 

+ 

OH 

= C2H20 

C2H 

+ 

02 

= C2HO 

C2H 

+ 

OH 

= C2HO 

C2HO 

+ 

02 

=2 . OCO 

C2HO 

+ 

O 

=2 . OCO 

C2HO 

+ 

OH 

=2 . OHCO 

C2HO 

+ 

H 

= CH2 

C2HO 

+ 

CH2 

= C2H3 

C2HO 

+ 

CH2 

= CH20 


2 . 

. 0C2HO 

= C2H2 

C2H20 

+ 

OH 

= CH20 

C2H20 

+ 

OH 

= C2HO 

C2H20 

+ 

H 

= CH3 

C2H20 

+ 

H 

* C2HO 

C2H20 

+ 

O 

= C2HO 

C2H20 

+ 

O 

= CH20 

M 

+ 

C2H20 

“ CH2 

C2H 


O 

= CO 

CH30 

+ 

02 

= CH20 

CH30 

+ 

H 

= CH 20 

M 

+ 

CH20 

= HCO 

CH 20 

+ 

OH 

= HCO 

CH20 

+ 

H 

= HCO 

CH20 

+ 

O 

= HCO 

CH3 

+ 

CH20 

= CH4 

CH3 

+ 

HCO 

= CH4 

CH3 

+ 

H02 

= CH30 

M 

+ 

CH3 

= CH2 

H 

+ 

CH3 

= H2 

O 

+ 

CH3 

= OH 

OH 

+ 

CH3 

= H20 

CH 

+ 

C02 

= HCO 

CH 

+ 

02 

= HCO 

CH 2 

+ 

02 

= CH20 

CH2 

+ 

O 

= CH 

CH2 

+ 

OH 

= CH 

CH2 

+ 

H 

= CH 

CH2 

+ 

CH2 

= C2H3 

CH2 

+ 

CH2 

= C2H2 


REACTOR + ROCKET EXP: CHAPTER 13, 


+ 

CH3 

5 . 0E+ 15 

0 . 

+ 

C3H7 

3 . 55E+12 

0 . 

+ 

CH3 

3 . 0E+ 14 

0 . 

+ 

H 

2 . 0E+17 

0. 

+ 

H2 

1 .26E+14 

0 . 

+ 

H02 

7.94 E+l 3 

0 . 

+ 

OH 

1 . 9E+14 

0 . 

+ 

H20 

2 . 5E+1 3 

0 . 

+ 

O 

2 .4E+13 

0. 

+ 

H 

6 . 3E+ 12 

0 . 

+ 

H 

5 . 0E+ 13 

0. 



2 . 4 E+l 4 

- .4 

+ 

H2 

1 .32E+14 

0 . 

+ 

OH 

1 . 13 E+14 

0. 

■f 

H20 

8 . 7 E+13 

0 . 

+ 

H 

1 . OE+17 

0. 


H02 

2 . OE+12 

0. 

+ 

H2 

4 . 8E+13 

0 . 

+ 

H 

2 . OE+13 

0 . 

+ 

C2H3 

1 .5E+14 

0 . 

+ 

H2 

2 . 6E+17 

0. 

+ 

H20 

4 . 8E+12 

0. 

+ 

CH20 

2 . 0E+12 

0. 

+ 

HCO 

3 . 3E+12 

0 . 

+ 

CH2 

2 . 5E+13 

0 . 

4- 

H 

3.0E+15 

0 . 

+ 

HCO 

3 . 98E+12 

0 . 

+ 

H2 

6 . OE+12 

0 . 

+ 

H 

3 . 3E+13 

0 . 

+ 

H20 

5 . OE+12 

0 . 

+ 

CH3 

3 .OE+13 

0 . 



3. OE+13 

0 . 

+ 

H 

4 . 2E+16 

0 . 

+ 

CO 

1 .6E+14 

. 0 

+ 

H 

4 . OE+14 

0 . 0 

+ 

H20 

6 . 3E+12 

0.0 

+ 

H 

3 . 2E+1 1 

0 . 0 

+ 

O 

5 . 00E+13 

0 . 

+ 

H 

2 -OE+13 

0 . 

+ 

OH 

1.46E+12 

0 . 

+ 

H 

1 . 202E+12 

0. 



1 . OE+13 

0. 

+ 

CO 

5. OE+13 

0. 

+ 

CO 

3 . OE+13 

0. 

+ 

C2H 

1 . OE+13 

0 . 

+ 2 , 

. OCO 

1 .OE+13 

0 . 

+ 

HCO 

2 . 8E+13 

0 . 

+ 

H20 

7 . 5E+12 

0. 

+ 

CO 

1 .13E+13 

0. 

+ 

H2 

7 . 5E+13 

0. 

+ 

OH 

5 . OE+13 

0. 

+ 

CO 

2 .OE+13 

0 . 

+■ 

CO 

2 . OE+16 

0 . 

+ 

CH 

5 .OE+13 

0 . 

+ 

H02 

1 . OE+13 

0. 

+ 

H2 

2 .OE+13 

0. 

•f 

H 

5. OE+16 

0. 

•f 

H20 

3 .OE+13 

0. 

+ 

H2 

2 . 5E+13 

0 . 


OH 

3.5E+13 

0 . 

+ 

HCO 

1 . 0E+10 

0.5 

+ 

CO 

3 . 0E + 11 

.5 

+ 

OH 

2 .OE+13 

0. 

+ 

H 

1.95E+16 

0. 

+ 

CH2 

2 . 7 E+l 1 

. 67 

+ 

CH2 

1 .9E+11 

.68 

+ 

CH2 

2 . 7 E+ll 

.67 

+ 

CO 

3 . 7 E+ 12 

0 . 

+ 

O 

1 .OE + 13 

0 . 

+ 

O 

5 . 0E+ 11 

0.5 

+ 

OH 

2 . 0E+11 

.7 

+ 

H20 

5 . 0E+ 11 

.5 

+ 

H2 

3 . 2E+11 

0.7 

+ 

H 

5. 0E+12 

0. 


H2 

4 .OE+13 

0. 


CASE 1 

83500. 
10300. 
33200. 
88000 . 
11900 . 
56000 . 
11720. 
5010 . 
28680 . 

0 . 

21000 . 

0 . 

9700 . 
7850 . 
3520 . 
31000 . 
5000 . 

0 . 

0 . 

10200 . 
79300. 
1230 . 
960 . 
1130 . 
5000 . 
32000 . 
-250 . 

0 . 

0 . 

0 . 

0 . 

0 . 

107000 . 

9890 . 
10660 . 
7000 . 
200 . 
1500 . 

0 . 

2500. 

0 . 

0 . 

0 . 

0 . 

2000 . 

0 . 

0 . 

3000 . 
3428 . 
8000 . 
8000 . 

0 . 

60000. 

0 . 

717 0 . 

0 . 

81000 . 
1200. 
3990 . 
3510 . 
6000. 

0 . 

0 . 

91600 . 
25700. 
25700. 
25700 . 

0 . 

0 . 

6960. 
25800. 
5900 . 
4970. 

0. 

0 . 
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HCO 

+ 

02 


= 

CO 

4 

HCO 

+ 

O 


— 

CO 

4 

HCO 

+ 

OH 


— 

CO 

4 

HCO 

+ 

H 


- 

CO 

4 

M 

+ 

HCO 


~ 

H 

4 

CO 

+ 

O 


~ 

CO 2 

4 

CO 

+ 

02 


- 

CO 2 

4 

CO 

+ 

OH 


= 

CO 2 

4 

CO 

+ 

H02 


= 

CO 2 

4 

o 

+ 

H2G 



OH 

4 

H 

4 

02 


= 

OH 

4 

O 

4 

H2 


= 

OH 

4 

H 

4 

H02 


- 

H2 

4 

O 

4 

HO 2 


= 

OH 

4 

H02 

4 

OH 


= 

H20 

4 

H 

4 

H02 


— 2 

- OOH 


H2 

4 

H02 


=S 

H202 

4 

OH 

4 

H202 


= 

H20 

4 

H02 

4 

H02 


= 

H202 

4 

H 

4 

H202 


- 

OH 

4 

M 

4 

H202 


= 2 

. OOH 


THIRDBODY 






H2 

2 

. 30 

02 


.7 8 


END 







H2 

4 

OH 


- 

H20 

4 

H 

4 

02 


= 

H02 

4 

THIRDBODY 






02 

1 

. 30 

N2 


1 . 3 


END 







M 

4 

H20 


= 

H 

4 

THIRDBODY 






H2 

4 

. 00 

02 


1.5 


CO 2 

4 

. 0 

END 




H 

4 

o 


- 

OH 

4 

M 

4 

H2 


as 

H 

4 

THIRDBODY 






H2 

4 

. 10 

02 


2 . 0 


END 







M 

4 

02 


= 

O 

4 

CH 

4 

N2 


= 

HCN 

4 

CN 

4 

H2 



HCN 

4 

O 

4 

HCN 


= 

OH 

4 

OH 

4 

HCN 


= 

HNCO 

4 

CN 

4 

0 


- 

CO 

4 

CN 

4 

OH 


= 

NCO 

4 

H2 

4 

NCO 


= 

HNCO 

4 

HNCO 

4 

H 


= 

NH 2 

4 

CN 

4 

02 


- 

NCO 

4 

CN 

4 

CO 2 


= 

NCO 

4 

0 

4 

NCO 


= 

NO 

4 

N 

4 

NCO 


= 

N2 

4 

H 

4 

NCO 


- 

NH 

4 

CH 

4 

NO 


= 

N 

4 

CH 

4 

NO 



0 

4 

NH 

4 

OH 


= 

N 

4 

H02 

4 

NO 


= 

NO 2 

4 

O 

4 

NO 2 


ss 

NO 

4 

NO 

4 

0 


= 

NO 2 

4 

NO 2 

4 

H 


= 

NO 

4 

NO 

4 

H 


= 

N 

+ 

NO 

4 

O 


s 

N 

4 

O 

4 

N2 


= 

NO 

4 

N 

4 

NO 2 


= 2 . 

ONO 


M 

4 

N20 


= 

N2 

4 

O 

4 

N20 


= 

N2 

4 

0 

4 

N20 


=2. 

ONO 


N20 

4 

H 


= 

N2 

4 

N02 

4 

H2 


= 

HN02 

4 

OH 

4 

N02 


= 

HN03 

4 

THIRDBODY 






02 

0 . 

70 

H2 


1.4 


OH 

4 

NO 



HN02 

4 

HNO 

4 

H 


- 

H2 

4 

H 

4 

NO 


= 

HNO 

4 

HNO 

4 

OH 


= 

H20 

4 


H02 

3. OE+13 

0 . 

0 . 

OH 

3 .OE+13 

0. 

0 . 

H20 

3 . OE+13 

0. 

0 . 

H2 

2 . 0E+ 1 3 

0 . 

0 . 

CO 

2 . 9 E+ 14 

0 . 

15570 . 

M 

2 . 4E415 

0 . 

4100 . 

0 

2 . 5E+12 

0 . 

47690 . 

H 

4 . 17E411 

0 . 

1000 . 

OH 

5 .75E413 

0 . 

22930 . 

OH 

6 . 8E413 

0 . 

18365 . 

O 

1 . 89E414 

0 . 

16400 . 

H 

4 . 20E+14 

0 . 

13750 . 

02 

7 . 28E+1 3 

0 . 

2126 . 

02 

5 . 0E+ 1 3 

0 . 

1000 . 

02 

8 . OE+12 


0. 


1.34E+14 

0 . 

107 0 . 

H 

7 . 91E+13 

0. 

25000 . 

H02 

6 . 1E412 

0 . 

1430 . 

02 

1 . 8E+12 

0 . 

0 . 

H20 

7 . 8E+ 1 1 

0 . 

0. 


1 .44E+17 

0 . 

45510 . 

H20 

6.0 H202 

6 . 6 

H 

4 .74E413 

0. 

6098 . 

M 

1 . 46E+15 

0 . 

-1000 . 

H20 

21.3 C02 

7 . 0 

OH 

1 .30E+15 

0 . 

105140 

H20 

20.0 N2 

1.5 

M 

7 . 1E+ 18 

-1 . 

0 . 

H 

2 . 2E+ 14 

0 . 

96000 

H20 

15.0 N2 

2 . 0 

0 

1 - 80E+18 

-1 . 

118020 

N 

1 . 0E+ 1 1 

0 . 

19000 . 

H 

6 . OE+13 

0 . 

5300 . 

CN 

1.4E+11 

.68 

16900 . 

H 

4 . OE+11 

0 . 

2800 . 

N 

1 .2E+13 

0. 

0 . 

H 

2 . 5E+ 14 

0 . 

6000 . 

H 

1 . OE+14 

0 . 

9000 . 

CO 

1 . OE+14 

0 . 

8500 . 

O 

3 . 2E+13 

0 . 

1000 . 

CO 

3 . 7 E+ 12 

0 . 

0 . 

CO 

2 . OE+13 

0 . 

0 . 

CO 

1 . OE+13 

0 . 

0 . 

CO 

2. OE+13 

0 . 

0 . 

HCO 

1 .6E+13 

0 . 

9940 . 

HCN 

2 . OE+12 

0. 

0 . 

H20 

5 . OE+11 

in 

o 

2000 . 

OH 

2 . 09E+12 

0. 

-477 . 

02 

1 . OE+13 

0 . 

596 . 

M 

5 . 62E+ 15 

0 . 

-1160 . 

OH 

3 . 47E+14 

0 . 

1470 . 

OH 

2 . 63E+14 

0 . 

50410 . 

02 

3 . 8E+9 

1 . 

41370 . 

N 

1 . 80E+14 

0 . 

76250. 


4 . OE+12 

0 . 

0 . 

0 

6 . 92E+23 

-2.5 

65000 . 

02 

1 . OE+14 

0 . 

28020 . 


6 .92E+13 

0 . 

26630 . 

OH 

7 . 59E+13 

0 . 

15100 . 

H 

2 . 4 E+ 1 3 

0 . 

29000 . 

M 

3 . 0E+ 1 5 

0 . 

-3800 . 

END 

M 

5 . 6E+15 

0 . 

-1700 . 

NO 

5 . OE+12 

0 . 

0. 

M 

5 . 4E+15 

0 . 

-600 . 

NO 

3 . 6E+13 

0 . 

0 . 


DISTANCE AREA CGS CGS 

&prob welstr= . true . , conc= . false . , wsf low= . true . , rxntst= true 

GxO^iS.O cxl=20.0, print=0 . 4 , 2 . 0 , 4 . 0 , rocket= . true . , htran= . true . , 
qmread= . false . , twall=700.0, pc=73.5, atbrot=2 . 325 , uend 
&WGp rob dot max— 16 00 . 0 , de lmd— 8 0 0.0, mpr = 1 , volume— 3 00.0 
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wcrhtr^ . true . , wsrhtl=0 . 05 , werhtO^ * 42 . 88 , &end 
ScGtart t=614.0, p=5.0, mdot=10.0, molef =. false . , x=0 . 2 , 


C3H8 0.0873262 

M2 0.6892887 

02 0.211232 

AR 0.011737 

CO 2 0.0004162 

EMD 


fcsolver emax=1.0E-4, atolsp=l . 0E- 13 , &end 
FINIS 


& end 


(ref. 39) and given by Bittker (ref. 40). The nitrogen-oxygen reactions were taken from reference 41 and those 
involving carbon monoxide and all hydrocarbon species from references 42 and 43. 

The blank line after the chemical mechanism signifies the end of the reaction list. The next line lists the 
inert (i.e., non-reacting) species argon. The next species field is blank, indicating the end of the inert species 
list. 


Problem setup data . - The next line contains the integration and assigned variables for the flow problem 
following the PSR computation and the input and output units. The words DISTANCE (starting in column 1) 
and AREA (starting in column 1 1) tell the code that an assigned-area calculation will be performed with dis- 
tance as the integration variable. Note that only the second field in this line has to contain information because 
(a) distance is the integration variable, (b) individual species concentrations at reactor inlet will be specified and 
(c) cgs units are used for both input and output. However, for illustrative purposes we have included the inte- 
gration variable and both input and output units: the word CGS starting in columns 2 1 and 3 1 , respectively. 

Next, the Problem Data File contains namelist PROB, in which the variables WELSTR and WSFLOW are 
set equal to TRUE to indicate, respectively, that a PSR problem and a flow problem following it are to be 
solved. The variable CONC is set equal to FALSE so that for the flow problem mass fractions will be printed 
(instead of the default molar concentrations). The variable RXNTST is set equal to TRUE so that the reaction 
mechanism validity test will be performed. The area profile for the flow problem is specified by means of the 
variables CXO (= 15.0) and CXI (= 20.0), which together indicate that area is a linear function of distance. 

The distance values at which output is required are entered into the array PRINT. Because rocket performance 
parameters are required ROCKET is set equal to TRUE and values supplied for the combustion chamber pres- 
sure PC (in psia) and the nozzle throat area ATHROT (in sq. in.). The chamber pressure will be considered 
equal to the PSR pressure, so PC = 73.5 psia (5 atm). Finally, HTRAN is set equal to TRUE to indicate that 
heat loss from the nozzle is to be considered. Since the built-in correlations are to be used for Q', QMREAD is 
set equal to FALSE and the wall temperature entered into TWALL. 

Since a PSR computation is required PROB is followed by namelist WSPROB. The variable DELMD (= 
mass flow rate increment of 800 g/s for successive convergences) tells the code that an assigned mass flow rate 
calculation is to be performed. The desired mass flow rate (1600 g/s) through the PSR is entered into 
DOTMAX. The volume of the reactor is given by VOLUME. The variable WSRHTR is set equal to TRUE, 
indicating that the problem is not adiabatic and heat loss rate must be computed. The coefficients for the Q 
calculation are the variables WSRHT0 and WSRHT1. The value MPR = 1 tells the code that PSR results are to 
be printed after every convergence. (Although the default value for MPR is unity, we have included this vari- 
able for demonstration purposes). 

Reactor inlet and initial conditions . - Next, namelist START gives the reactor inlet temperature, T, and 
mass flow rate, MDOT, for the first converged solution. Because the PSR solution is started with conditions 
close to the equilibrium state we assign a small value (= 10 g/s) for MDOT. The reactor pressure, P, is set 
because an assigned- area flow problem follows the PSR problem. Because area was specified in PROB, 
START does not list any of the three quantities AREA, V and MACH. The variable MOLEF is set equal to 
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CO " Ce " ,ra,i0 " 8 a ‘ “« «» via maSS fractions (instead 

Iv ,lZrr H ®;T PrcViOUS / y we m X - °- 20 for *• Mt'al value of distance for the flow ptohlem. Final- 
ly, because the initial reaction time for this problem is zero, TIME is not given. 

Namelist START is followed by the species names and their mass fractions at reactor inlet The end of the 
species list is denoted by a line containing the word END in the first three columns. 

r-nn, a M ggra | ti0n r nt u r ° l ! prohlem - ' Namelist SOLVER the initial species concentrations and 

contains values for the local relative (EMAX) and absolute (ATOLSP) error tolerances for the flow problem. 


data. 


HMSJine. - The last line contains the word FINIS starting in column 1 to indicate the end of the 


case 


^jle R^uhs Table 13 2 gives some of the computed results for the PSR problem and for the flow problem 
at x - 4 cm. The PSR solution required 22 iterations and 1.2 s execution time. The computational work for the 

CPU Zt em WM ^ f ° OW9: 158 StePS ’ 203 derivative evaluat 'ons, 30 Jacobian matrix evaluations, and 4.2 s 

proce ^Te n ^ODF W rh Pr0blem ~ AcCU ™ Y ° f Inte P rati ™ - When using any numerical integration 

procedure hke LSODE, the user must have an idea of the effects of local error tolerance parameters on The 

results The error control should be set tight enough to give the desired accuracy with the smallest amount of 
computational work. To examine how the computational work and solution accuracy are influenced by the local 
error tolerances we study the ignition of a stoichiometric hydrogen-air mixture in supersonic flow. 

The chemical mechanism is the H-O-N reaction subset of the propane-air reactions used for the first test 

hZ' H ,IKe * meChan,Sm f ° r that case wa9 found to be legal we will not ask for mechanism validity testing 
| We r tem P° rari, y change the thermodynamic data for the hydroperoxyl radical HO, to 
reflect a new value for its heat of formation at 298.15 K. * ^ 

j. A t s ‘™ hlometric hydrogen-air mixture at an initial temperature of 1559 K and an initial pressure of 0 956 

d In? A°r ng , m 8 constant ; area ( 200 ° cm2 ) duct at a Mach number of 5.0. The integration variable is 

rr he d SOlUt, °? S FeqU, l r ! dat X = 3 - 048> 6096 ’ 7 - 620 ’ and 12 '9 cm. The initial mixture composition 
is to be specified using die simplified input option. In particular, the equivalence ratio will be given and the 

ZTITTTV h SamC 8S that bUilt int ° thC Code - Also ’ the initial mixture will consist of only the 
fuel and the standard oxidant species, that is, it will not contain any trace species. X 

ture,gi'ven°by “ n ° nadiabatic ’ With heat loss rate P er unit distan ce, O', (in cal/s/cm) as a function of tempera- 


-42.88 + 5.863T, 


(13.3) 


K - Fi " ally - ,he inpu ' wm be ^ — 

D ^cnption of Problem Data File . - The Problem Data File for this case is shown in table 13.3 The first 
line of the file contains the word CARD to tell the code that thermodynamic data for some (or all) species are 
provi e in the Problem Data File. The next four lines give the required data for HC^. Because this is the 
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TABLE 13.2 


COMPUTED RESULTS FOR PROPANE-AIR PSR-PLUS-FLOW PROBLEM 


PSR problem (m = 1600 g/s) 


Reaction time, s 


Pressure, atm 


Velocity, m/s 


Temperature, K 


Density, g/cm 3 


Specific heat, cal/(g-K) 


Specific heat ratio 


7.361 xlO' 4 


Species mass fractions 


3.933 XlO -6 


1.006 XlO' 8 


7. 496 xlO' 4 


2 . 934 XlO*® 


1.245 XlO -4 


Flow problem (x = 4 cm) 


2.108 xlO' 5 



8. 186 xlO' 5 



3.618X10' 7 


1.442 xlO' 4 


6.337 XlO' 4 


2.073 xlO' 4 


9.783 xlO" 5 


3.077 xlO" 3 


7. 130 xlO' 4 


4.010 xlO -7 



2.977 xlO' 5 


2 . 930 XlO" 5 


3.117 XlO" 5 


1.255 XlO' 4 


















































































TABLE 13.3. - PROBLEM DATA FILE FOR HYDROGEN- AIR SUPERSONIC FLOW EXAMPLE PROBLEM 


CARD 

300 . 000 

HO 2 


1000.000 5000.000 

J 9/78H 1.0 2 . 


- ~ ' ■ — - ■ “ • « • juu.uuu 5000.000 

0.4017306 0E 01 0 . 2 217 5 883 E - 02 - 0 . 577 1017 IE - 06 0 . 7 13 7 2 882E - 10 - 0 . 36 4 


-0.11412445E 04 0.37846051E 01 0.35964102E 01 0 . 52500748E- 03 0.751 
- 0 . 9 5674952E- 08 0 . 3659762 8E- 11 - 0 . 89333502E 03 0.66372671E 01 0 
END 


33.00669 1 
58591E-14 2 
18344E-05 3 
.00000000 4 


o 

+ 

H20 

= OH 

H 

+ 

02 

= OH 

0 

+ 

H2 

= OH 

H 

+ 

H02 

= H2 

0 

+ 

HO 2 

= OH 

H02 

+ 

OH 

= H20 

H 

+ 

HO 2 

=2 . OOH 

H2 

+ 

H02 

« H202 

OH 

♦ 

H202 

= H20 

H02 

+ 

H02 

= H202 

H 

+ 

H202 

= OH 

M 

+ 

H202 

=2 . OOH 


THIRDBODY 
H2 2.30 

END 

H2 + 01 

H >02 

THIRDBODY 
02 1.30 

END 

M + H2 

THIRDBODY 
H2 4.00 

END 

H +0 

M + H2 

THIRDBODY 
H2 4.10 

END 

M +02 

H02 + NC 

O + NO 

NO +0 

NO 2 + H 

NO +0 

O + N2 

NO + H 

M + N2 

O + N2 

O + N2 

N + NO 


* O 

= NO 2 

= NO 
= NO 2 

* NO 

- N 

- NO 
= N 
=» N2 
= N2 
“2 . ONO 
=2 . ONO 


N20 + 

H 

ss 

N2 

NO 2 + 

H2 

- 

HN02 

OH + 

N02 

~ 

HN03 

THIRDBODY 




0 , 

.70 

H2 


OH + 

NO 

= 

HN02 

HNO + 

H 

= 

H2 

H + 

NO 


HNO 

HNO + 

OH 

= 

H20 

END 





I HEAT 

TRANSFER: CHAPTER 13, 

CASE 2 

OH 

6.8E+13 0. 

18365 . 

0 

1.89E+14 0. 

16400 . 

H 

4.20E+14 0. 

13750 . 

02 

7.28E+13 0. 

2126 . 

02 

5.0E+13 0. 

1000 . 

02 

8.0E+12 0. 

0 . 


1.34E+14 0. 

107 0 . 

H 

7.91E+13 0. 

25000 . 

H02 

6.1E+12 0. 

1430. 

02 

1.8E+12 0. 

0 . 

H20 

7.8E+11 0. 

0 . 


1.44E+17 0. 

45510 . 

H20 

6.0 H202 

6 .6 

H 

4.74E+13 0. 

6098. 

M 

1.46E+15 0. 

- 1000 . 

H20 

21.3 H2 

3 .0 

OH 

1.30E+15 0. 

105140 

H20 

20.0 N2 

1 . 5 

M 

7.1E+18 -1. 

0 . 

H 

2.2E+14 0. 

96000 

H20 

1S.0 N2 

2 . 0 

O 

1.80E+18 -1. 

118020 

OH 

2.09E+12 0. 

-477 . 

02 

1.0E+13 0. 

596 . 

M 

5.62E+15 0. 

- 1160 . 

OH 

3.47E+14 0. 

147 0 . 

02 

3.8E+9 1. 

41370 . 

N 

1.8E+14 0. 

76250 . 

OH 

2.63E+14 0. 

50410 . 

0 

6.92E+23 -2.5 

65000 . 

02 

1.0E+14 0. 

28020 . 


6.92E+13 0. 

26630 . 


4.0E+12 0. 

0 . 

OH 

7.59E+13 0. 

15100 . 

H 

2.4E+13 0. 

29000 . 

M 

3.0E+15 0. 

- 3800 . 

END 



M 

5.6E+15 0. 

-17 00 . 

NO 

5.0E+12 0. 

0 . 

M 

5.4E+15 0. 

-600 . 

NO 

3.6E+13 0. 

0 . 


&prob cxO— 2 000.0, print=3 . 048, 6 . 096 ,1 . 620, 12 . 19, 
htran= . true . , qmread= . true . , htl=5.863, ht0=-42.88 
&etart p=0.956, t=1559.0, mach=5.0, 

eratio=1.0, scc=0.0, sch=2.0, bcox^O.o, &end 

END 

&solver &end 
FINIS 


only species for which thermodynamic data are to be furnished in the Problem Data File, the next line contains 
the word END in columns 1 to 3. The title for the problem follows the above information. 

Then, we give the reaction list, which is ended by using a different method than that used in the previous 
case. The word END is written in columns 4 to 6 of the line following the last reaction. The combustion air 
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contains small amounts of C0 2 and Argon. Since we have chosen not to include in the mechanism any reaction 
involving C0 2 , the next line of the file contains the names of the two inert species C0 2 (= C02) and Ar (= 

AR). For this case we use an alternate method of ending the list of inert species than in the previous example. 
Instead of leaving the third species field blank, we write END in its first three columns. 

The Integration and Assigned Variables, Units and Fuel Name line contains a blank first field and the word 
AREA in the second field because we are performing an assigned-area flow problem with distance as the inte- 
gration variable. Since the simplified composition input option is being used, the fuel name (H2) must be given 
on this line, starting in column 41. Finally, since both input and output units are cgs, columns 21 to 40 are 
blank. 

In namelist PROB we indicate a constant area profile by setting a nonzero value for only CXO (= 2000.0). 
The desired print stations are entered into the array PRINT. Finally, HTRAN and QMREAD are set equal to 
TRUE to indicate that heat transfer rates are to be computed for the problem and that the necessary coefficients 
will be provided by the user. The two coefficients in the Q' expression, equation (13.3) are listed as the vari- 
ables HT0 and HT1. (We have included QMREAD for illustrative purposes only. Its default value is TRUE.) 

Namelist START is next and the variables P (= initial pressure), T (= initial temperature) and MACH 
(= initial Mach number) provide the necessary initial thermodynamic and fluid mechanic properties. Since the 
initial distance and reaction time are both zero, neither TIME nor X is set. The nonzero value for ERATIO 
(= 1.0) indicates that the simplified composition input option is being used, and that too via the fuel-oxidant 
equivalence ratio. The latter fact means that we must also give the nonzero stoichiometric coefficients of car- 
bon (SCC), hydrogen (SCH) and oxygen (SCOX) in the fuel. Because the fuel is hydrogen (H 2 ) SCH is set 
equal to 2.0. (For illustrative purposes we have assigned a value of zero for the other two coefficients.) Be- 
cause the equivalence-ratio input option requires the (default) value of TRUE for MOLEF, this variable is not 
given. Finally, since the built-in oxidant composition is to be used, the variables ARAT, CRAT and NOXRAT 
are not set. 

No individual initial mole fraction is listed after namelist START because the initial mixture does not con- 
tain any trace species. A blank line, or one containing the word END in the first three columns, must, neverthe- 
less, follow START, as shown in table 13.3. 

The data file ends with namelist SOLVER and the usual FINIS line. Since default values are to be used 
for all variables, including EMAX (= 10' 5 ) and ATOLSP (= 10“ 14 ), SOLVER contains only the beginning and 
ending of the namelist. 

Computed Results and Error Considerations . - To examine the dependences of solution accuracy and com- 
putational work on the local error tolerances, this test case was run with various values for EMAX. In particular, 
EMAX was progressively decreased from 10’ 2 to 10~ 9 by a factor of 10. For this study ATOLSP was set equal 
to 10“ 9# EMAX. 

The effects of EMAX can be ascertained from table 13.4, which gives selected results at x = 6.096 cm. 

The computational work, as measured by the first four quantities in this table, increased significantly as EMAX 
was decreased. However, the differences in the computed solutions were quite small. Temperature decreased 
by about 0.1 percent and the largest change in a species mole fraction was for nitric oxide (NO), which 
decreased by about three percent, when EMAX was reduced from 10" 2 to 10~ 9 . All other mole fractions 
changed by less than one percent. Table 13.4 shows that the computed results become essentially tolerance- 
independent at EMAX = Iff 4 . In fact, for this problem LSODE is quite accurate even for EMAX = 10 2 . 
However, this may not always be the case, so it is usually necessary to find the optimal error parameter for any 
new problem by a few trial computations. 
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The effects of ATOLSP on solution accuracy and computational efficiency were studied by progressively 
increasing ATOLSP from 10 “ 14 to 10 ' 7 by a factor of 10- All results were generated with an EMAX value of 
I O' 5 . Selected results at x = 6.096 cm are presented in table 13.5. The computational work generally decreased 
when ATOLSP was increased. The results were relatively insensitive to ATOLSP in the range [10T ,10"^]. 
However, for ATOLSP > 10 ' 8 they deviated from their accurate values. In particular, for ATOLSP = 1 O' 'the 
solution was significantly inaccurate, with several species concentrations being less than zero. Also, no heat 
release had occurred and the temperature was little changed from its initial value. The same behavior was ob- 
served at x = 12.19 cm: the temperature was 1556 K, instead of 2683 K (the accurate value). For this ATOLSP 
the maximum local error in a species concentration is only about two ppm. These results demonstrate the im- 
portance of being conservative in selecting ATOLSP. Table 13.5 shows that the optimal ATOLSP is 10' 12 : note 
that it required less computational work than 10 " 11 despite being more accurate. The above value of 10 " 12 may 
be peculiar to this case, so, in general, a trial-and-error optimization procedure for ATOLSP is necessary. 


Sensitivity Test Case: Constant-Volume, Adiabatic, Static Benzene-Oxygen-Argon Combustion Reaction 

The last test case concerns kinetics and sensitivity analysis calculations in a constant-volume, adiabatic, 
static system. The problem describes the ignition and subsequent combustion of a near-stoichiometric (4> = 
1.007) benzene-oxygen-argon mixture (with 85.728 percent argon in the mixture). The initial temperature and 
pressure are 1405 K and 2.3868 atm., respectively. The reaction mechanism contains 40 species and 120 reac- 
tions, so reaction mechanism testing will be required. Thermodynamic data for all species are to be taken from 
the Standard Thermodynamic Data File. For both input and output cgs units are to be used. We will specify 
the initial mixture composition by means of species mole fractions. 


Sensitivity coefficients are required for the 14 dependent variables °OH> a H> a H 2 ’ a O> a H 2 0’ 

a CO’ a C2H2’ a C6H50H» a C02’ ^ an< * P res P ect to all three rate coefficient parameters of the seven 

reactions listed below: 


Reaction 

number, 

j 

Reaction 

1 

c 6 h 6 + o 2 ^c 6 h 5 o + oh 

6 

C 6 H 6 + OH ** C 6 H 5 + H 2 0 

8 

c 6 h 5 o C 5 H 5 + CO 

12 

C 6 H 5 OH <•* CgHjO + H 

17 

c 5 h 6 + o 2 ~c 5 h 5 o + oh 

18 

C 6 H 5 OH + OH C^O + H 2 0 

104 

H + 0 2 **> OH + O 


Sensitivity coefficients with respect to the initial values of the six variables o c ^h^, o OH , a H 2 0 > a Ar» T, and p 

must also be computed. The solution is required at the five output stations KT 6 , I0“ 5 , 6xl0" 5 , 2.8xl0‘ 4 , and 
3x1 O ' 4 s. The standard format is to be used for printing the sensitivity coefficients with respect to the rate coef- 
ficient parameters. Finally, any normalized sensitivity coefficient with magnitude less than 1CT 7 is to be set 
equal to zero. 
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TABLE 13.5 - VARIATIONS OF COMPUTATIONAL WORK AND SOLUTION WITH ATOLSP FOR H.-AIR TEST CASE 

[EMAX - 10 , X * 6.096 cml ^ 

































































































































































Description of Problem Data File 


The required Problem Data File for this case is listed in table 13.6 and described below. 

Thermodynamic and Reaction Mechanism Data . - The first line of the Problem Data File contains the word 
TAPE in columns 1 to 4 because all thermodynamic data are to be taken from the Standard Thermodynamic 
Data File. The second line contains the case title. It is followed by the chemical mechanism, which was taken 
from reference 40. The blank line after the last reaction denotes the end of the reaction list. It is followed by a 
line with the name (AR) of the inert species argon in columns 1 and 2. The blank species field in columns 1 1 
to 18 designates the end of the inert species list. 

Problem Setup Data . - The next line contains the word TIME starting in column 1. This is the integration 
variable for a constant volume (or any) static reaction problem. The remainder of the line is blank, since there 
is no assigned variable, (the default) cgs units are used for both input and output and the simplified composition 
input option is not used. 

Namelist PROB, which is placed after the above line, contains the following variables. The array PRINT 
lists the print stations (in seconds) at which output is required. The variable RXNTST is set equal to TRUE 
because the legality of the reaction mechanism is to be tested. The variables RHOCON and SENCAL are set 
equal to TRUE because this is a constant-volume (density) problem and sensitivity analysis computations are 
required. Finally, TINY is set equal to 1.0x10’^ so that any normalized sensitivity coefficient with magnitude 
less than this value will be set equal to zero. 

Initial Conditions and Integration Controls . - In namelist START, which follows PROB, we give initial 
values for only the temperature, T, and pressure, P, because the test case involves a constant-density calculation. 
The initial reaction time is zero, so TIME is not set. Following this namelist, the species names and their initial 
mole fractions (because MOLEF is not set equal to FALSE in START) are given. The blank line indicates the 
end of the list of initial concentrations. Next, namelist SOLVER gives EMAX and ATOLSP. 

Sensitivity Analysis Data . - All three data types that may be given for sensitivity analysis computations are 
listed. The first keyword designating data type is SENSVAR, which indicates that the dependent variables 
whose sensitivity coefficients are required will be given on the following line(s). Fourteen variables are listed: 
eight on the first line and six on the second. They include the names of the twelve species, temperature and 
pressure. The dependent variable list is concluded by the word END in the variable field following 
PRESSURE. (Note that if an exact multiple of eight variables had been listed, an additional line that either is 
blank or contains the word END starting in column 1 would have been 
required.) 

The next keyword is INIT, which signifies that sensitivities with respect to the initial values of certain 
variables must be computed. These variables are given on the next line, using the same format as that used 
above for the dependent variables. 

The last keyword is REAC, which means that sensitivity coefficients with respect to rate coefficient param- 
eters are required. The keyword is followed by namelist SENRXN, which gives the necessary information 
about the rate coefficient parameters and reactions to be considered. The variables SENSAJ, SENSNJ and 
SENSEJ are set equal to TRUE because sensitivity coefficients with respect to the pre-exponential factor, Aj, 
temperature exponent, nj, and activation energy, Ej, are needed. The array RXNUM contains the reaction num- 
bers for which sensitivity coefficients must be produced. Since these coefficients do not have to be computed 
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TABLE 13.6. - PROBLEM DATA FILE FOR BENZENE - OXYGEN ARGON SENSITIVITY TEST CASE 

TAPE 

BENZENE-02 -ARGON SHOCK IGNITION SENSITIVITY TEST CASE: CHAPTER 13 CASE 3 


C6H6 

+ 

02 

= C6HSO 

+ 

C6H6 

+ 

C6H5 

= C12H10 

+ 



C6H6 

= C6H5 

+ 

C6H6 

+ 

H 

= C6H5 

+ 

C6H6 

+ 

0 

= C6H50 

+ 

C6H6 

+ 

OH 

= C6H5 

+ 

M 

♦ 

C4H3 

= C4H2 




C6HSO 

= C5H5 

+ 

C6H5 

+ 

02 

= C6H50 

+ 

C6H5 

+ 

H02 

= C6H50 




C6H5 

= C4H3 

+ 



C6H50H 

= C6H50 


C6H5CH 

+ 

H 

= C6H6 


C6HSOH 

+ 

H 

= C6H50 


C5H5 

+ 

C6H50H 

= C6H50 

+ 



C5H6 

= C5H5 

+ 

C5H6 

+ 

02 

= C5H50 

+ 

C6HSOH 

+ 

OH 

= C6H50 

+ 

C6H50H 

+ 

H02 

= C6H50 

+ 



C5H50 

= C4H5 

+ 

C5H5 

+ 

0 

= C5H50 


C5H5 

+ 

OH 

= C5H40H 

+ 



C5H40H 

= C4H4 

+ 

C5H5 

+ 

H02 

= C5H50 

+ 


2 

. 0C6H5 

= C12H10 




C4H5 

= C2H3 

+ 

C4H2 

+ 

O 

= C2HO 

+ 

C4H2 

+ 

OH 

= HCO 

+ 

C4H2 

+ 

0 

= CO 

+ 

M 

+ 

C2H4 

= C2H2 


C2H4 

+ 

OH 

= C2H3 

+ 

C2H4 

+ 

O 

= CH3 


C2H4 


0 

= CH20 

+ 

C2H4 

+ 

OH 

= CH3 

+ 

M 

+ 

C2H3 

= C2H2 

+ 

C2H3 

+ 

02 

= CH20 

+ 

C2H3 

+ 

H 

= C2H2 

+ 

C2H3 

+ 

OH 

= C2H2 

+ 

C2H3 

+ 

CH2 

= C2H2 

+ 

C2H3 

♦ 

C2H 

~ 2 . 0C2H2 


C2H3 

+ 

0 

= C2H20 

+ 

CH2 

+ 

CH2 

= C2H2 

+ 

CH2 

+ 

CH2 

= C2H3 


CH2 

+ 

OH 

= CH 

+ 

CH2 

+ 

O 

= CH 

+ 

CH2 

+ 

02 

= CO 2 

+ 2 

M 

+ 

C2H2 

= C2H 

+ 

C2H2 

+ 

C2H2 

= C4H3 

+ 

C2H2 

+ 

0 

= CH2 

+ 

C2H2 

+ 

0 

= C2HO 

+ 

C2H2 

+ 

OH 

= C2H 


C2H2 

+ 

OH 

- C2H20 

+ 

C2H2 

+ 

C2H 

= C4H2 

+ 

C2H2 

+ 

CH2 

= C3H3 

+ 

M 

+ 

C3H4 

= C3H3 

+ 

C2H20 

+ 

OH 

= CH20 

+ 

C2H20 

+ 

OH 

= C2H0 

+ 

C2H20 

+ 

H 

= CH3 


C2H20 

+ 

H 

= C2H0 

+ 

C2H20 

+ 

0 

= C2H0 

-f 

C2H20 

♦ 

0 

= CH20 

+ 

M 

+ 

C2H20 

= CH 2 

+■ 

C2HO 

+ 

02 

=2 . OCO 

+ 

C2HO 

+ 

0 

—2 . OCO 

+ 

C2HO 

+ 

OH 

=2 . OHCO 


C2HO 

+ 

H 

= CH2 


C2HO 

+ 

CH2 

= C2H3 

+ 

C2HO 

+ 

CH2 

= CH20 

+ 


2 . 

OC2HO 

= C2H2 

+ 2 

C2H 

+ 

OH 

= C2H0 

+ 

C2H 

+ 

02 

= C2H0 

+ 

C2H 

+ 

0 

= CO 

+ 

M 


CH4 

= CH3 

+ 

CH4 

+ 

02 

= CH3 

+ 

CH4 

+ 

H 

= CH3 

+ 

OH 

+ 

CH4 

= CH3 

+ 

O 

+ 

CH4 

= CH3 

+ 


OH 

4 . OE+13 

0 . 

34000 . 

H 

4 . OE+1 1 

0 . 

4000 . 

H 

i . OE+16 

0 . 

108000 

H2 

2.5E+14 

0. 

16000 . 

H 

2 .783E+13 

0 . 

4910 . 
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emax-1 . 0E- 6 , 

atolep=l . OE- 

15 , 

&end 




SENS VAR 










C6H6 

OH 

C6H5 

H 


H2 

O H20 


CO 

C2H2 

C6H50H C5H6 

CO 2 


TEMP 

PRESSURE END 


I NIT 










C6H6 

OH 

H20 


AR 


TEMP 

DENSITY END 


REAC 











Scoenrxn sensaj = . true . , sensnj = . true . , sensej= . true . , 
rxnum= 1.0,6.0,8.0,12.0,17.0,18.0,104.0, tend 
FINIS 


for all reactions, ALLRXN is not employed. Finally, neither OUTPUT nor ORDER is set because (a) the stan- 
dard format is to be used for printing the normalized sensitivity coefficients with respect to the rate parameters 
and (b) reaction numbers do not have to be listed in order of decreasing importance. 
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Computed Results and Effects of Local Error Tolerances 

rnmm.!lt Ctl0rl h 0f **“ appropriate local error tolerance parameters is especially important for sensitivity analysis 
computations because the accuracy of the sensitivity coefficients is controlled by the accuracy of the^kinetic 

lv die 0 "' L°f 7<?2 ?o-lO he COmpu,ed results vaf y with ^ local error tolerances, EMAX was progressive- 
ly decreasedffrom 10 to 10 0 by a factor of 10, while keeping ATOLSP = lO'^EMAX. Table 137 shows 

work for the combined 1“?“' COncentrations ’ te mperature, pressure, and the computational 

at r. . b | “" S ,‘2.^ com P u “« ions ' The kinetic solution was quite inaccurate 

MAX - 10 and did not stabilize until EMAX was decreased to 10*. This behavior is different from that 

I3 ' 4> ** — - * i“ g 

of ,he execution ,ime on EMAX » h,ch — 

The effects of ATOLSP on the accuracy of the solutions were studied by progressively increasing ATOLSP 
from 105to 10 with EMAX equal to 10*. The kinetic results are given In table 13.8. Ag^Te ^exlutfon 
time includes that required for sensitivity analysis. Table 13.8 shows that ATOLSP has to be^ncreased to IQ- 8 
any app^iable differences from the accurate values are noted in the results. Note that even ATOLSP = 

W ,S Sufflclent 'y accurate - 11 was also significantly less expensive than ATOLSP = 10 15 . Table 13 8 rein- 
forces the desirability of optimizing ATOLSP. 0 re n 

The effects of EMAX on the normalized sensitivity coefficients (<S >} with rennet to th« a- 

tion valuesare presentedin tables ,3.9 * ,3.14. <L Y,' L Si ‘^22^2 ^ TZ 

le number of species j and the subscript 0 denotes initial condition. The first four tables give the {<S >} 
with respect to the initial concentrations of benzene, hydroxyl radical, water, and argon. Tabfes 13 13 and" 13 14 
ist the normalized sensitivity coefficients with respect to the initial temperature and density, respectively The 
lx tables show that the {<S ij >} have a much stronger dependence on EMAX than the kinetic solution Thev 
SK au — y - EMAX is reduced from 10* to 10* and stabilize to three significanl *££ « ^ 

become essentially roLlel^leT" 81 ^ maSmUCh 88 ** SO ' Uti ° n EMAX = to 

EMAX bl ^W° 13 - 23 show . the variati ons of several rate coefficient parameter sensitivity coefficients with 
EMAX The first seven tables give {< Sjj >} with respect to the {AT. Tables 13.22 and 13.23 present Te eT 

^>1 IrahT g d^ ° n the r rmaHZed SCnSitivity coefflcients with aspect to ng and Eg, respectively All 
{ S,j>} stabilized to three significant figures only when EMAX was reduced to 10*, similar to foe initial condi 

ion sensitives Thus EMAX should be approximately 10* for accurate sensitivity analy is 
this typical ignition and combustion problem. y computations tor 

The variations of the {<S (J >} with ATOLSP are shown in tables 13.24 to 13.29 for several parameters 
The first the tables give normalized sensitivity coefficients with respect to the initial mole numbers of benzene 
and water and the initial temperature. Tables 13.27 to 13.29 present {<S >} with respect to A n and F 
respectively These tables show that variation of ATOLSP in the range lV 5 to 10^ has a small effectin’ the 

AtoST To-9 han8e 5 a fraCtio " of 1 percent - Although somewhat less accurate, the results ob- 
tained with ATOLSP = 0 were adequate. The run with ATOLSP = 10' 8 did, however, incur errors greater 

den ce TT’ \ ^ sensitivities of ^5- Again, the sensitivity coefficients display similar depen- 

dence on the local error tolerance as the kinetic section. Thus, the need ^generate reliable klnet" results Is 
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indicated. It is therefore recommended that first optimal EMAX and ATOLSP values be established for the 
kinetic solution and then sensitivities generated with somewhat more accurate tolerances. 
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TABLE 13.8. - VARIATIONS OF COMPUTATIONAL WORK AND KINETIC SOLUTION WITH ATOLSP FOR BENZENE-OXYGEN-ARGON TEST CASE 

[EMAX = lCT 6 , t = 300 |13] 
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TABLE 13.9. - VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <0Y /do r H ,> WITH 

FOR BENZENE - OXYGEN * ARGON TEST CASE 1 ~6 H 6'° 

[ATOLSP = 10 9 *EMAX , t = 300 jis] 
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TABLE 13.10 - VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <dY :/d0 0H 0 > WITH 

FOR BENZENE-OXYGEN-ARGON TEST CASE 
[ATOLSP = 10 5 * EMAX , t = 300 jis] 
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TABLE 13.12. - VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <0Y 1 /do fKr 0 > WITH 

FOR BENZENE -OXYGEN -ARGON TEST CASE 
[ATOLSP = 1CT 9 *EMAX, t = 300 fis] 
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TABLE 13.14. - VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <dY i /dp 0 > WITH EMAX FOR 

BENZENE -OXYGEN -ARGON TEST CASE 
[ATOLSP = 10‘ 9 *EMAX, t = 300 ps] 
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TABLE 13.15.- VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <0Y,/dA > WITH EMAX FOR 

BENZENE -OXYGEN -ARGON TEST CASE 
[ATOLSP = 10 9 « EMAX, t = 300 usl 
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TABLE 13.16 - VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <0Y i /dk 6 > WITH EMAX FOR 

BENZENE ‘OXYGEN -ARGON TEST CASE 
[ATOLSP = 10' 5 *EMAX, t = 300 |is] 
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VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <dY/0A fi > WITH 
BENZENE -OXYGEN -ARGON TEST CASE 1 

[ATOLSP = 10 9 «EMAX, t = 300 \ib] 






















































































TABLE 13.18.- VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <aY,/dA 12 > WITH EMAX FOR 

BENZENE -OXYGEN -ARGON TEST CASE 
[ATOLSP = 10' 9 *EMAX, t = 300 >is] 
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TABLE 13.21. - VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <dY:/dA.,,> WITH 

FOR BENZENE -OXYGEN- ARGON TEST CASE " 

[ATOLSP = 10' 9 *EMAX, t = 300 jib] 





















































































































TABLE 13.22. - VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <0Y,-/0n a > WITH EMAX FOR 

BENZENE -OXYGEN -ARGON TEST CASE 
[ATOLSP = 10' 9 *EMAX, t = 300 \is] 
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TABLE 13.23 - VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <0Y;/0E 8 > WITH EMAX FOR 

BENZENE 'OXYGEN -ARGON TEST CASE 
[ATOLSP = 10 EMAX, t = 300 ps] 
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TABLE 13.24. - VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <id\ i /0o { 
WITH ATOLSP FOR BENZENE -OXYGEN -ARGON TEST CASE 
[EMAX = 10' € , t = 300 \is] 
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TABLE 13.27. - VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <dY;/dA, 
WITH ATOLSP FOR BENZENE -OXYGEN -ARGON TEST CASE 







































































































TABLE 13.28. * VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <&Y 1 /dn 
WITH ATOLSP FOR BENZENE * OXYGEN - ARGON TEST CASE 
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TABLE 13.29. - VARIATION OF NORMALIZED SENSITIVITY COEFFICIENT <OYjdE 
WITH ATOLSP FOR BENZENE -OXYGEN -ARGON TEST CASE 
[EMAX = 10~ 6 , t = 300 \ie) 







































































































APPENDIX B - ACCESSING SYSTEM CLOCK 


To measure the execution time required by LSENS, the user must provide a subprogram, REAL FUNC- 
TION SECCPU, which computes the incremental central processing unit (CPU) time in seconds. This function 
calls the system clock and is given in tables B1 to B8 for several common computing systems. If the call to the 
system clock is not available or known, the dummy version of SECCPU given in table B9 may be used. 


TABLE Bl. - LISTING OF FUNCTION 
SECCPU FOR THE IBM 370 COMPUTER 


REAL FUNCTION SECCPU(TIME) 
C 

INTEGER ITIME 
C 

REAL TIME 
REAL CPTIME 
C 

CALL CPUTIM(ITIME) 

C 

CPTIME = FLOAT(ITIME)* 1 .0E-03 
SECCPU = CPTIME - TIME 
C 

RETURN 

C END OF FUNCTION SECCPU 

END 


TABLE B2. - LISTING OF FUNCTION SECCPU FOR 
THE AMDAHL 5870 
COMPUTER AND THE VM 
OPERATING SYSTEM 


REAL FUNCTION SECCPU(TIME) 

C 

CHARACTERS DATTIM 
C 

REAL TIME 

REAL ECPU ,ETCPU ,ETIME 
C 

CALL DATETM(DATTIM,ECPU ,ETIME,ETCPU) 
C 

SECCPU = ECPU - TIME 
C 

RETURN 

C END OF FUNCTION SECCPU 

END 
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TABLE B3. - LISTING OF FUNCTION 
SECCPU FOR THE AMDAHL 5870 
COMPUTER, THE UTS OPERATING 
SYSTEM AND THE FUJITSU 
77 COMPILER 

REAL FUNCTION SECCPU(TIME) 

C 

REAL TIME 
REAL CPTIME 
C 

CALL CLOCK(CPTIME, 1,1) 

C 

CPTIME = CPTIME* 1.0E-03 
SECCPU = CPTIME - TIME 
C 

RETURN 

C END OF FUNCTION SECCPU — 

END 


TABLE B4. - LISTING OF FUNCTION SECCPU 
FOR VAX COMPUTERS 

REAL FUNCTION SECCPU(TIME) 

C 

INTEGER ITIME 
C 

REAL TIME 
REAL CPTIME 
C 

INCLUDE ’($JPIDEF)’ 

C 

CALL LIB$GETJPI(JPI$_CPUTIM„JTIME„) 
C 

CPTIME = FLOAT(ITIME)* 1 .0E-02 
SECCPU = CPTIME - TIME 
C 

RETURN 

C END OF FUNCTION SECCPU 

END 
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TABLE B5. - LISTING OF FUNCTION 
SECCPU FOR CDC CYBER AND CRAY 
COMPUTERS 


REAL FUNCTION SECCPU(TIME) 
C 

REAL TIME 
REAL CPTIME 
C 

CALL SECOND(CPTIME) 

C 

SECCPU * CPTIME - TIME 
C 

RETURN 

C END OF FUNCTION SECCPU 

END 


TABLE B6. - LISTING OF FUNCTION 
SECCPU FOR THE CONVEX C220 
MINICOMPUTER AND THE ALLIANT 
FX/S COMPUTER 


REAL FUNCTION SECCPU(TIME) 

C 

REAL TIME 
REAL CPTIME 
REAL DUM 
C 

DIMENSION CPTIME(2) 

C 

DUM = ETIME(CPTIME) 

C 

SECCPU = CPTIME(1) - TIME 
C 

RETURN 

C END OF FUNCTION SECCPU — 

END 
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TABLE B7. - LISTING OF FUNCTION 
SECCPU FOR THE SUN SPARCstation 1 

REAL FUNCTION SECCPU(TIME) 

C 

REAL TIME 
REAL CPTIME 
REAL DUM 
C 

DIMENSION CPTIME(2) 

C 

EXTERNAL f771id 
C 

DUM = ETTME( CPTIME) 

C 

SECCPU = CPTIMEO) - TIME 
C 

RETURN 

C END OF FUNCTION SECCPU 

END 


TABLE B8. - LISTING OF FUNCTION 
SECCPU FOR THE IBM RISC SYSTEM/6000 

REAL FUNCTION SECCPU(TIME) 

C 

INTEGER ITIME 
C 

REAL TIME 
REAL CPTIME 
C 

ITIME = MCLOCK() 

C 

CPTIME = FLO AT( ITIME)* I.0E-02 
SECCPU = CPTIME - TIME 
C 

RETURN 

C END OF FUNCTION SECCPU 

END 
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TABLE B9. - LISTING OF DUMMY 
FUNCTION SECCPU THAT CAN BE 
USED IF CALL TO SYSTEM CLOCK 
IS NOT AVAILABLE OR KNOWN 

REAL FUNCTION StCCPU(TIME) 

C 

REAL TIME 
C 

SECCPU = 0.0 
C 

RETURN 

C END OF FUNCTION SECCPU 

END 
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APPENDIX C - CODE MODIFICATIONS 

The present version of LSENS has built-in values for the following parameters: maximum number of ele- 
ments (atoms, etc.), maximum number of species, maximum number of reactions, maximum number of third- 
body collisional reactions, maximum number of species with third-body collisional efficiencies different from 
unity for any one reaction, maximum number of tabular values for the assigned variable (pressure or area) and 
temperature, and the maximum number of print stations. The necessary modifications to change the present 
values of these quantities are described in this appendix. Information is also given on changing logical tape unit 
numbers and some parameters that control the integration and sensitivity analysis computation. 

All of the above quantities are set in the BLOCK DATA module. Table Cl lists these variables, describes 
them and gives their current values. All variables in this table are integers, except SMEST, which is a double 
precision variable, and TESTNO, which is real. Although any quantity may be reset by the user, we strongly 
recommend against changing the current values of JDMJAC, JDMOPT, and MESFLG. In particular, resetting 
MESFLG to zero will switch off all error messages from XERRWV. The user will then be unaware of any 
difficulty experienced by LSODE, including illegal input. The reason for any premature execution termination 
may also be a mystery. The integer JDMOPT controls how the integration is to be continued after every solu- 
tion output. The current value (= 0) indicates that the integration is to be continued normally. If JDMOPT is 
set to any nonzero value, LSODE will be reinitialized after every printout, which may result in significantly 
increased execution times and a reduction in the accuracy of both the kinetics and sensitivity analysis results. 
The integer JDMJAC controls the frequency of Jacobian matrix update while performing sensitivity analysis. 

The current value (= 0) means that the Jacobian matrix is to be updated on every step. Any nonzero value for 
JDMJAC will result in the matrix being updated only on those steps for which LSODE found this update neces- 
sary for the kinetics problem. Since the accuracy of the sensitivity coefficients is not tested, it may deteriorate 
if this option is used. 

The maximum number of elements that comprise the chemical species can be changed by using table C2. 
Table C3 shows how to reset the maximum number of (reacting-plus-inert) species, LSMAX, that the reaction 
mechanism can involve. In addition to the modifications listed in this table, if LSMAX is increased, the lengths 
of the real (RWORK) and integer (IWORK) work arrays must be reset in the MAIN subprogram. However, if 
LSMAX is reduced, the current dimensions for the two arrays need not be reset, although doing so will decrease 
storage requirements. These arrays are used for both integration of kinetics problems and sensitivity analysis. 
When sensitivity analysis is required, the length of RWORK will have to be reset if the maximum number of 
reactions, LRMAX, is increased. 

The minimum length, LRW, of RWORK depends on the number, N, of ordinary differential equations 
(ODEs) and the method flag, MF (see eq. (9.1) and table 9.4). For sensitivity analysis computations, the total 
number of sensitivity parameters, NDMSEN, must also be taken into account. The minimum length, LIW, of 
IWORK depends on N, the corrector iteration technique indicator, MITER (see table 9.5), and whether or not 
sensitivity analysis is needed. 

For a kinetics-only problem (i.e., no sensitivity analysis), the required LRW for each MF value is given in 
table C4. In this table, MAXORD is the maximum method order to be used, and has the default values 12 for 
the Adams-Moulton method and 5 for the backward differentiation formula method. The maximum number of 
ODEs solved by the code is equal to LSMAX + 3. The required LIW is given in table C5 for each MITER. 

The LRW value used in the current version of LSENS is that required for MF = 21, the default method. 
Thus, even if LSMAX is not increased the user may have to reset LRW if a different MITER is selected. In 
addition, if MF = 14, 15, 24, or 25, the user must set IWORK (1) = ML and IWORK (2) = MU in the MAIN 
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TABLE Cl. - USER-ADJUSTABLE VARIABLES IN BLOCK DATA MODULE? 


Variable 

name 

Description 

Current 

value 

JDMJAC 

Switch to specify when Jacobian matrix is to be updated for sensitivity computations. JDMJAC = 0 
causes this matrix to be computed at every time step. JDMJAC = 1 causes the Jacobian matrix to be 
computed only when it is updated by LSODE 

0 

JDMOPT 

Switch to specify mode of continuation of integration after every solution printout. JDMOPT = 0 in- 
structs LSODE to continue integration normally. JDMOPT = 1 causes LSODE to restart solution after 
every printout 

0 

LDAT 

Logical tape unit number for temporary storage of input data for each individual case 

7 

LREAD 

Logical tape unit number for Problem Data File 

5 

LRMAX 

Maximum number of reactions 

250 

LSCR 

Logical tape unit number for temporary storage of thermodynamic data included in Problem Data File 

9 

LSMAX 

Maximum number of reacting-plus-inert species 

50 

LTHM 

Logical tape unit number for Standard Thermodynamic Data File 

4 

LTRAP 

Logical tape unit number for Transport Properties Data File 

S 

LUNIT 

Logical tape unit number for (a) error messages from subroutine XERRWV for both kinetics and sensi- 
tivity analysis computations and (b) information regarding storage and computational work require- 
ments for sensitivity analysis 

6 

LWRITE 

Logical tape unit number for all output, except the quantities listed above for LUNIT 

6 

MESFLG 

Control flag for printing error messages from subroutine XERRWV. MESFLG = 0 means do not print 
any error message. MESFLG = 1 means print all messages 

1 

NBLANK 

Identification number to denote no species in reactant or product location in a reaction (used internally) 

52 

NLMAX 

Maximum number of elements 

15 

N PHOTO 

Identification number to denote “reactant*’ HNU for photochemical reaction (used internally) 

53 

NPMAX 

Maximum number of print stations 

100 

NTBMAX 

Maximum number of tabular values for both the assigned variable (pressure or area) and temperature 

100 

NTHRD 

Identification number to denote third body species M (used internally) 

51 

SMEST 

In normalizing sensitivity coefficients, variable values less than SMEST in magnitude are set equal to 
SMEST 

10- 35 

TBRMAX 

Maximum number of third-body collisional reactions 

35 

TBSMAX 

Maximum number of species with third-body collisional efficiencies different from 1.0 for any one 
reaction 

10 

TESTNO 

Value (essentially minus infinity) to which all print stations and tabular values of assigned variable arc 

-10 35 


| initialized 

a All variables are integers, except SMEST, which is a double precision variable and TESTNO, which is real. 
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subprogram before the call to subroutine SENDDM. Here ML and MU are, respectively, the lower and upper 
half-bandwidths of the Jacobian matrix. If MITER = 4 (i.e., MF = 14 or 24), the user must replace subroutine 
PEDERV with a routine that satisfies the requirements described in reference 22. 

If sensitivity analysis is required, only a value of 21 may be specified for the method flag. The code as- 
sumes a maximum method order of five, even if a smaller value is set in namelist SOLVER (see item 9 in the 
section “Problem Data File for Single Case” of chapter 11). The array RWORK will require an additional 
N(6»NDMSEN + N + 1) + 2 words for the sensitivity analysis computations. In this case, the maximum num- 
ber of ODEs solved is equal to LSMAX + 2. The total LRW needed for the (kinetics-plus-sensitivity analysis) 
computation is given in table C4. Here NDMSEN is the total number of initial conditions and rate coefficient 
parameters with respect to which sensitivity coefficients are to be computed, and has a maximum value of 

LSMAX + 2 + 3*LRMAX. The dimension of the array IWORK must be increased by at least N + 20, and the 
LIW value that must be set is given in table C5. 

For either computation, that is, kinetics-only or kinetics-plus- sensitivity, the user must reset the LRW and 
LIW values given in the MAIN subprogram. In addition, the dimensions specified in this routine for RWORK 
and IWORK must be changed to reflect the new LRW and LIW. 

The modifications needed to change the maximum number of reactions are given in table C6. If LRMAX 

is increased and the sensitivity analysis option is used, LRW may have to be increased, as described above (see 
also table C4). 

The necessaiy actions to assign new values for the maximum number of third-body collisional reactions 
and the maximum number of species with third-body collisional efficiencies different from unity are listed in 
tables C7 and C8, respectively. Table C9 shows how to change the maximum number of tabular values for the 
assigned variable and temperature. Finally, to reset the maximum number of print stations table CIO may be 
consulted. 


TABLE C2. - MODIFICATIONS NEEDED TO CHANGE 
MAXIMUM NUMBER OF ELEMENTS (NLMAX) 


1* Change NLMAX in BLOCK DATA to required value 

2. Change variable dimensions in the following common 
blocks 

Common block 

Variable (dimension)" 

ELMNTS 

ELNAM(NLMAX) 

MISC 

ELNO(NLMAX) 

MATX 

GA(max(LSMAX+ 1 ,NLMAX+2), 
max(LSMAX+2,NLMAX+2)), 
GX(max(LSMAX+ 1 .NLMAX+2)) 

SPECES 

ELSP(NLMAX, LSMAX) 


"LSMAX is the maximum number of reacting-plus-inert species 
(see table C3) 
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TABLE C3. - MODIFICATIONS NEEDED TO CHANGE MAXIMUM NUMBER OF SPECIES (LSMAX) 


1. Changes in BLOCK DATA 

a. Reset LSMAX to desired maximum number of species 

b. Reset following three variables to indicated values 
NTHRD = LSMAX+1 

NBLANK = LSMAX +2 
NPHOTO = LSMAX+3 

2. Change variable dimensions in the following common blocks 

Common 

block 

Variable (dimension) 4 ’* 5 

COND 

SIGMA(LSMAX) 

DFDPA 

DFDPJ(LSMAX+2, 3»LRMAX) 

GHSC 

GRT(LSMAX), HRT(LSMAX), SR(LSMAX), CPR(LSMAX), DCPR(LSMAX) 

INERT 1 

DISNM(LSMAX) 

MATX 

GA(max(LSMAX+l, NLMAX+2), max(LSMAX+2, NLMAX+2)), GX(max(LSMAX+l, NLMAX+2)) 

PDDTRM 

PDDSIG(LSMAX) 

SAVRAT 

FF(LSMAX+3) 

SENNAM 

SNAMES(2, LSMAX+3) 

SENNOR 

SIVNP(LSMAX+2), YINV(LSMAX+2) 

SENPAR 

SCIV(LSMAX+3, LSMAX +2), SCRP(LSMAX+3, LRMAX+3), IDPAR(2,LSMAX+2) 

SENSOL 

DYDYO(LSMAX+2, LSMAX +2), SENSE(LSMAX+3, LRMAX, 3) 

SPCONC 

C(LSMAX) 

SPECES 

ENfLSMAX), ENLN(LSMAX), DELN (LSMAX), ELSP(NLMAX, LSMAX) 

SPECl c 

DSPNM(LSMAX) 

SPEC2 

MW(LSMAX), W(LSMAX), STOICH(LSMAX, LRMAX), OMEGA(LSMAX, LRMAX) 

TCOF 

TC(LSMAX t 7, 2) 

TRAN 

VTC(4, LSMAX, 2), ICV(LSMAX), VCSP(LSMAX, 2) 

3. Change variable dimensions in DIMENSION statements in the following subprograms 

Subprogram 

Variable (dimension) b 

MAIN 

Y0(LSMAX+3), ATOL(LSMAX+3) 

GAUSS 

COEFX(LSMAX + l) 

HETRAN 

DLVC(LSMAX) 

KINP 

C(LSMAX) 

OUT2 

PRC(LSMAX) 

PEDERV 

PBBSIG(LSMAX), PGSIG(LSMAX), PM2SIG(LSMAX), PSISIG(LSMAX), PS2SIG(LSMAX) 

RXNTAB 

NRIMP(LSMAX, LRMAX), OMOUT(LSMAX, LRMAX) 

WSOUT 

EN (LSMAX), FMOUT(4, LSMAX) 

WSR 

ES(LSMAX), DLSIG(LSMAX), SIGLN(LSMAX), TZ(LSMAX+1) 

SNSTAB 

NRIMP(LSMAX+3, LRMAX, 3) 

4. Rewrite one EQUIVALENCE statement in subroutine KINP as follows 

EQUIVALENCE (EFFM, DSPNM(LSMAX+1), (BLANK, DSPNM(LSMAX+2)), 
(HNU, DSPNM(LSMAX+3)) 


a NLMAX is the maximum number of elements (see table Cl). 
b LRMAX is the maximum number of reactions (see table C4). 

c In subroutines KINP and OUT1 the dimension of DSPNM in common block SPEC1 must be set equal to (LSMAX+3) and not that 
given in the table. 
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TABLE C4. - MINIMUM LENGTH, LRW, REQUIRED BY THE REAL WORK 


ARRAY RWORK 

1 

Problem type 

Method flag, 

Minimum length required for RWORK, 


MF 

LRW 

Kinetics-only 

10, 20 

20 + N(MAXORD + 4) 


11, 12, 21, 22 

22 + N(MAXORD + N + 4) 


13, 23 

22 + N(MAXORD + 5) 


14, 15, 24, 25 a 

22 + N(MAXORD + 2*ML + MU + 5) 

Kinetics and sensi- 

21 

24 + N(6»NDMSEN +2N + 10) 

tivity analysis 0 



ML and MU are, respectively, the lower- and upper-half bandwidths of the 
banded Jacobian matrix. If the choice MF = 14 or 24 is made, subroutine 
PEDERV must be replaced. 
b OnIy MF = 21 is allowed. 


TABLE C5. - MINIMUM LENGTH, LIW, REQUIRED BY THE INTEGER WORK 

ARRAY IWORK 


Problem type 

Iteration method, 
MITER® 

Minimum length required for IWORK, 
LIW 

Kinetics-only 

0, 3 

20 


1, 2, 4, 5 

20 + N 

Kinetics and sensi- 

1 

40 + 2N 

tivity analysis 1 * 




a See table 9.5. 

b Only MITER = 1 is allowed. 










TABLE C6. - MODIFICATIONS NEEDED FOR CHANGING MAXIMUM 
NUMBER OF REACTIONS (LRMAX) 


1. Change LRMAX in BLOCK DATA to required value 

2. Change variable dimensions in the following common blocks 

Common 

block 

Variable (dimension) 8 

DFDPA 

DFDPJ(LSMAX+2, 3‘LRMAX) 

KOUT2 

DELH(LRMAX) 

RATLOG 

DAFLOG(LRMAX) 

REAC2 

LSR(4, LRMAX), XX(LRMAX), DPX(2, LRMAX), 
RATE(LRM AX) , BRATE(LRMAX), LRTYPE(LRMAX) 

RRAT 

A(LRMAX), N(LRMAX), EACT(LRMAX), NUM(LRMAX) 

SENPAR 

SCRP(LSMAX+ 3 , LRMAX, 3), DTRDRP(2, LRMAX, 3), 
NREAC(LRMAX) 

SENSOL 

SENSE(LSMAX+ 3, LRMAX, 3) 

SPEC2 

STOIC(LSMAX, LRMAX), OMEGA(LSMAX, LRMAX) 

STCS 

NSTOIC(4, LRMAX), NSPRP(2, LRMAX) 

ZERCON 

FBRATE(2, LRMAX) 

3. Change variable dimensions in DIMENSION statements in the following 

subroutines 

Subroutine 

Variable (dimension)* 

OUT2 

PRX(LRMAX), EQUIL(LRMAX) 

RXNTAB 

NRIMP(LSMAX, LRMAX), OMOUT(LSMAX, LRMAX) 

SENSIN 

RXNUM(LRMAX) 

SNSTAB 

NRIMP(LSMAX+3, LRMAX, 3) 


a LSMAX is the maximum number of reacting-plus-inert species 
(see table C3). 


TABLE Cl. - MODIFICATIONS NEEDED TO CHANGE 
MAXIMUM NUMBER OF THIRD-BODY REACTIONS (TBRMAX) 


1 . Change TBRMAX in BLOCK DATA to required value 

2. Change variable dimensions in the following common blocks 

Common block 

Variable (dimension)® 

REAC2 

MM(TBRMAX), LR3RD(TBRMAX), NS3RD(TBRMAX), 
I3RD(TBSMAX, TBRMAX) 

RRAT 

M (TBSMAX, TBRMAX) 

SPEC1 

TBSPNM (TBSMAX, TBRMAX) 


“TBSMAX is the maximum number of third-body species with efficiencies differ- 
ent from unity (see table C8). 
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TABLE C8. - MODIFICATIONS NEEDED TO CHANGE 
MAXIMUM NUMBER OF SPECIES WITH THIRD-BODY 
EFFICIENCIES DIFFERENT FROM UNITY (TBSMAX) 


1. Change TBSMAX in BLOCK DATA to required value 


2. Change variable dimensions in the following common blocks 

Common block 

Variable (dimension) 8 

REAC2 

I3RD (TBSMAX, TBRMAX) 

RRAT 

M (TBSMAX, TBRMAX) 

SPEC1 

TBSPNM(TBSMAX, TBRMAX) 


*TBRMAX is the maximum number of third-body reactions (see 
table Cl). 


TABLE C9. - MODIFICATIONS NEEDED FOR CHANGING MAXIMUM NUMBER OF 
TABULAR VALUES FOR ASSIGNED VARIABLE (PRESSURE OR AREA) AND 
TEMPERATURE (NTBMAX) 


1. Change NTBMAX in BLOCK DATA to required value 

2. Change varia 

>le dimensions in the following common blocks 

Common block 

Variable (dimension) 

Alternate name (dimension), if any, for variable and 
subprogram(s) where alternate name is used 

CUBASV 

CUBTMP 

SAVTMP 

SAVVAR 

XVSA2 

XVST2 

CUBX(NTBMAX), 

CUBY(NTBMAX), 

CUBM(NTBMAX) 

CUBXT(NTBMAX), 

CUBYT(NTBMAX), 

CUBMT(NTBMAX) 

XTB(NTBMAX), 

TTB(NTBMAX), 

TMPTB(NTBMAX) 

CXTB(NTBMAX), 

CATB(NTBMAX), 

CXTTB(NTBMAX), 

CTMPTB(NTBMAX) 

XTB(NTBMAX), 

ATB(NTBMAX) 

XTTB(NTBMAX), 

TMPTB(NTBMAX) 

DUMST 1 (NTBMAX) in MAIN 
DUMST2(NTBMAX) in MAIN 
DUMST3(NTBMAX) in MAIN 
DUMSV1 (NTBMAX) in MAIN and OUT1 
DUMSV2(NTBMAX) in MAIN and OUT1 
DUMSV3(NTBMAX) in MAIN and OUT1 
DUMS V 4(NTBM AX) in MAIN and OUT1 
XTBSAV(NTBMAX) in KINP 
ATBS A V (NTBMAX) in KINP 
XTTBS V (NTBMAX) in T1NP 
TTBSAV(NTBMAX) in TINP 

3. Change variabl 

e dimensions in DIMENSION statements in the following subroutines 

Subroutine 

Variable (dimension) 

CUBS 

KINP 

SPLINE 

X(NTBMAX), Y(NTBMAX), CUBX(NTBMAX), CUBY(NTBMAX) 
CUBM(NTBMAX) 

XTB(NTBMAX), TTB(NTBMAX), ATB(NTBMAX) 

X(NTBMAX), Y(NTBMAX), M(NTBMAX), SPS(NTBMAX), SPT(NTBMAX) 
U(NTBMAX), V(NTBMAX), TX(NTBMAX) 




TABLE CIO. - MODIFICATIONS NEEDED TO CHANGE MAXIMUM NUMBER 
OF PRINT STATIONS (NPMAX) 


1. Change NPMAX in BLOCK DATA to desired value 

2. Change variable dimensions in the following common blocks 

Common 

block 

Variable (dimension) 

Alternate name (dimension) for variable and 
subprogram(s) where alternate 
name is used 

PRIN 

PRIN2 

SAVTMP 

PRINT(NPMAX) 

APRINT(NPMAX), 

PRINT(NPMAX) 

TPRJNT(NPMAX) 

CPRINT(NPMAX) in KINP and TTNP 
DUMP21 (NPMAX) in MAIN 
DUMP22(NPMAX) in MAIN 
DUMST6(NPMAX) in MAIN 
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PART C 

ILLUSTRATIVE TEST PROBLEMS* 


*Excerpted from: Bittker, D. A. and Radhakrishnan, K., "LSENS - A General Chemical Kinetics and Sensitivity Anal- 
ysis Code for Gas-Phase Reactions. III. Illustrative Test Problems," NASA RP, in press. 
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APPENDIX D - KINETICS TEST CASES 


In this appendix we describe 16 kinetics-only (i.e., no sensitivity analysis) test cases that are provided with 
the code. These cases were chosen to illustrate both the problem types that can be solved by LSENS and the 
options built into it. Therefore, users can find among them a model problem that can be easily modified to suit 
their needs. To demonstrate the various options for the ACTION switch all cases were set up in a single data 
file, which is listed in table Dl. We now describe each problem in some detail, including the source of the 
chemical mechanism used. 


Description of Test Cases 


Case 1 

The first case illustrates the shock-wave initiated decomposition of pure bromine. It shows the use of the 
shock-kinetics option and the boundary- layer correction for area given by Mirels (refs. 1 to 3). The variable 
SHOCK is set to TRUE in namelist PROB and the boundary layer parameters LSUBM and ETA are also given. 
The values of pressure, Mach number and temperature in namelist START are the incident shock conditions. 
The inert species xenon is listed on the line following the blank line which signals the end of the reaction list. 
The composition of the initial (unshocked) gas mixture is given as mole fractions following namelist START, 
and the list is ended with an END line. The rate expression used for the decomposition reaction was measured 
by Warshay (ref. 4). The namelist SOLVER, which lists the error control parameters EMAX and ATOLSP, is 
at the end of the data, just before the FINIS card which ends the case. 

Case 2 

Test case 2 is a stoichiometric hydrogen-air ignition in supersonic flow through a constant -area duct with 
heat transfer from the system computed as a linear function of temperature. For this and all other completely 
new cases, the word NEW appears on the ACTION line after the title. The hydrogen-oxygen reaction mecha- 
nism is that of Brabbs and Musiak (ref. 5) and the nitrogen-oxygen-hydrogen reactions are from Brabbs et al. 
(ref. 6). Namelist PROB contains the area profile information (the constant area CXO), the heat-transfer equa- 
tion coefficients HTO and HT1, and the list of print stations (in cm.) in the array PRINT. Initial composition is 
given by the special input which specifies fuel name and stoichiometry plus equivalence ratio for the fuel-stan- 
dard air mixture in namelist START. The fuel name, H2, appears in columns 41 and 42 of the problem assign- 
ment, units and fuel name line. Because the standard air contains small percentages of non-reacting carbon 
dioxide and argon, these species are listed as inert species after the reaction list. 

Case 3 

This case is the same problem as case 2 and illustrates the use of the CHANGE and ADD options of the 
ACTION switch. We have temporarily changed the pre-exponential factor for the reaction 2 HO 2 ** H 2 0 2 + 0 2 
and added the reaction of O atom with H 2 0 2 to the mechanism to test the effect of these changes on the com- 
puted results. Both the CHANGE and ADD lists end with a blank line. The word REPEAT should not be used 
after the ADD list because LSENS automatically uses the rest of the mechanism and other data which are un- 
changed from the previous case. On the problem assignment, units and fuel name line FPS units have been 
specified for input of any new data. The only new information that is given in Namelist PROB is the print- 
station list in feet. We have also set the variable EXCHR equal to TRUE to obtain the print out of net energy 
exchange rates for each reaction instead of the net reaction conversion rates. In Namelist START initial temper- 
ature and pressure are given in FPS units and the mass fuel-oxidant ratio is given for the initial mixture. The 
stoichiometric coefficients of the fuel are not needed when this ratio is given; however, they are saved automati- 
cally when the ADD or REPEAT option is used. Comparison of the computed results of cases 2 and 3 showed 
close agreement. Therefore the two changes made in the mechanism for this case were not used in any other 
test cases. 



Case 4 


This case is the ignition of a stoichiometric hydrogen-oxygen mixture flowing in a duct whose pressure 
profile is assigned as a linear function of distance. The flow is subsonic and heat transfer is assigned as a linear 
function of temperature. Note that the default value of QMREAD is TRUE. It has been set in namelist PROB 
only for illustrative purposes. Initial composition is given by the same method as in case 2 and the mechanism 
is the hydrogen-oxygen portion of the mechanism for that case. Output is specified in FPS units, but input is in 
the default (CGS) units. Therefore, the values given in the array PRINT are in centimeters. 

Case 5 

This case is the static ignition of a methane-oxygen-nitrogen mixture with an assigned pressure profile 
which increases linearly with time. Heat transfer from the system is given by the Otto cycle correlation option 
in LSENS. In namelist PROB note that the logical variable QMREAD must now be set equal to FALSE and 
values of the variables BORE, STROKE, TWALL and RPM are given. The chemical mechanism builds on that 
of case 2 by adding the oxidation and decomposition reactions of methane and its oxidation products ethane, 
ethylene, and acetylene, as well as the reactions of carbon monoxide and the formyl (HCO) radical. Also in- 
cluded are reactions of ketene (C 2 H 2 O), ketyl radical (C 2 HO) and formaldehyde taken from references 7 and 8. 

Case 6 

This is the adiabatic ignition of methane in supersonic flow at a constant assigned pressure of 1.73 atm. 

The chemical mechanism is the same as for case 5. In Namelist PROB the logical variable COMBUS has been 
set equal to TRUE so that the code will perform an assigned pressure and enthalpy equilibrium computation, 
which gives the final conditions that the kinetics computations would approach at long reaction times. With the 
pressure assigned, LSENS computes a reaction area profile as a function of distance. 

Case 7 

This is the same methane-air problem as case 6. However, the area profile computed in case 6 is now 
assigned as a table of distance and area values and pressure is computed. We illustrate here the use of the 
REPEAT option of the ACTION switch. Output is requested at values of the area which are listed in the array 
APRINT. Computed results are close to, but not identical to those of case 6. Small differences arise because 
area is now computed by interpolation in the table of values at each step. 

Case 8 

This case is also the same methane-air problem as case 6. Now both the area and temperature profiles 
computed in case 6 are assigned as tables of values. The REPEAT option is used again to save data from the 
previous case, including the area versus distance table which was used in case 7. Since temperature is assigned 
as a function of distance in namelist TMPDAT, output is requested at values of temperature, which are assigned 
in the array TPRINT. 

Case 9 

This case is a methane-air reaction in supersonic flow with both temperature and pressure assigned constant 
values. The REPEAT option is used again so that the chemical mechanism of case 6 is used. The variable 
COMBUS is set equal to TRUE so that an assigned pressure and temperature equilibrium problem will be 
performed before the kinetic computation. 

Case 10 

This case is the adiabatic, constant-volume ignition of methanol and oxygen in a static system. The mech- 
anism was obtained by adding to the reactions of case 6 ten reactions involving methanol and CH 2 OH taken 
from reference 9. The variable RHOCON is set equal to TRUE in namelist PROB. The simplified combustion 
input is used for this rich (fuel equivalence ratio = 2.0) mixture. However, very small initial concentrations of 
three trace species are also read in following namelist START. These additional mole fractions may be read in 
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if their sum does not exceed the code error limit (l.OxK)- 4 ) for the deviation of the initial mole fraction sum 
from umty. Nonce also that the starting pressure of one atmosphere is written as 760 mm. of mercury and the 
variable MMHG is set equal to TRUE in namelist START. * 

Case 1 1 

This case illustrates a propane-air perfectly stirred reactor combustion process followed by a flow reaction 
of the products expanding through a diverging nozzle. The reaction mechanism is obtained by adding three 
propane and propyl radical reactions (ref. 8) to the methane-air mechanism of case 6. We demonstrate, first of 
all, a typical assigned-mass PSR problem setup and, second, the option to perform an assigned-atea flow prob- 
em using the output conditions from the PSR as input conditions for the flow problem. Note that the data for 
the flow problem in namelist PROB include the setting of the logical variable ROCKET equal to TRUE for 
rocket performance parameter computatations. Values of ATHROT and PC must also be given. 

Case 12 

u, iS the ^^-temperature ionization of air in subsonic flow. It shows the use of the logical vari- 

ables DBUGO and ORDER m Namelist PROB to obtain the individual net molar formation rates o/each spe- 
cies by every reaction m which the species participates. Setting ORDER equal to TRUE is probably more use- 
ful, because the net production rates are printed in order of decreasing magnitude and none of the zero rates are 
printed. The chemical mechanism contains reactions of both neutral and ionic species. Rate expressions for 
neutral-species reactions are the same as used for previous test cases. However, the conversion between oxygen 
atoms and molecular oxygen is written as the recombination process here. The rate expression for it is taken 
romi reference 10, with the pre-exponential factor increased because the collision partners are N, and O, in- 
stead of argon. Rate expressions for ion-molecule reactions were taken from reference 11. 

Case 13 

This case is the high-pressure reaction of hydrogen and carbon monoxide in a constant-volume and temper- 
ature static system. The variable COMBUS is set equal to TRUE to obtain an assigned temperature and volume 
equilibrium computation. The variables RHOCON and TCON are set equal to TRUE in namelist PROB and 

initial temperature and pressure are assigned in namelist START. The chemical mechanism is a small portion 
or the mechanism of case 6. 

Case 14 

This case is the photolytic ignition of a stoichiometric hydrogen-oxygen mixture in a constant volume 
static system. The variable COMBUS is set equal to TRUE to obtain an assigned internal energy and volume 
equilibrium computation. The chemical mechanism is that of case 4 with the addition of the photolysis of the 

H 2 and 0 2 molecules. The constant rate coefficients for these reactions were set arbitrarily to give ignition at 
about 1 second of reaction time. 6 


Case 15 

This example is a methane-air ignition reaction in supersonic flow with the area profile assigned as a table 

Ponm 0 ^ y deCreasing values in the arra y ATB as a Action of the increasing XTB values (namelist 
B). The print stations are assigned at values of the area and are given in the array APRINT Notice that 

they are given in decreasing order, as are the ATB values, and that values different from those in the area table 
may be given. The first value in the ATB array should not be given in the APRINT array. It will be ignored if 
present. For this problem initial values of temperature, Mach number and pressure are set in namelist START. 

Case 16 

This case isthe same as case 15 except for the designation of print stations, so the REPEAT action option 
has been used. The print stations are listed as values of distance in the array PRINT and are, of course, in 
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increasing order. We have repeated the ATB and XTB arrays in namelist PROB for illustration purposes only. 
These arrays are saved by use of the REPEAT option, and do not have to be listed again unless the user wants 
to do so. 


TABLE DJL . - PROBLEM DATA FILE FOR KINETICS -ONLY TEST CASES 


TAPE 

LSENS BROMINE DISSOCIATION IN A SHOCK TUBE 
M + BR2 —2 . OBR 6.99E+11 0.50 

THIRDBODY 

BR2 3.80 END 


CASE 1 
35500 . 


XE 

DISTANCE AREA 


&prob 

lsubm 

=32200 

• 0, 

eta=0.5, shock- 

: . true . , 




print 

= 0 . 05 

,2.0,4 

. 0, 

&end 






&start 

p=o . 

1227, i 

mach=3 .2646 , t=299 . 

9 , &end 




BR2 

0 . 

01 








XE 

0 . 

99 








END 










&solver 

emax 

W 

o 

H 

II 

2, , 

atolsp=l . 0E- 10 , 

&end 




FINIS 










LSENS 

HYDROGEN 

- AIR TEST WITH 1 

HEAT TRANSFER 

STOICH 

CASE 2 

NEW 










O 

+ 

H20 


= OH 

+ 

OH 

6.8E+13 

0 . 

18365 . 

H 

+ 

02 


= OH 

+ 

O 

1.89E+14 

0 . 

16400 . 

O 

+ 

H2 


= OH 

+ 

H 

4 .20E+14 

0 . 

13750. 

H 

+ 

H02 


= H2 

+ 

02 

7 . 28E+13 

0. 

2126 . 

O 

+ 

HO 2 


= OH 

+ 

02 

5.0E+13 

0. 

1000 . 

H02 

+ 

OH 


= H20 


02 

8.0E+12 

0. 

0 . 

H 

+ 

H02 


=2 . OOH 



1.34E+14 

0 . 

1070 . 

H2 

+ 

H02 


= H202 

+ 

H 

7 . 91E+13 

0 . 

25000. 

OH 

+ 

H202 


= H20 

+ 

H02 

6.1E+12 

0 . 

1430. 

H02 

+ 

H02 


= H202 

+ 

02 

1.8E+12 

0. 

0. 

H 

+ 

H202 


= OH 

+ 

H20 

7 . 8E+11 

0. 

0 . 

M 

+ 

H202 


=2 . OOH 



1 .44E+17 

0. 

45510 . 

THIRDBODY 









H2 

2 

. 30 

02 

.7 8 


H20 

6.0 H202 

6.6 

END 










H2 

+ 

OH 


= H20 

+ 

H 

4 .74E+13 

0. 

6098. 

H 

+ 

02 


= H02 

+ 

M 

1 .46E+15 

0 . 

-1000 . 

THIRDBODY 









02 

I 

. 30 

N2 

1 . 3 


H20 

21.3 H2 


3 .0 

END 










M 

+ 

H20 


= H 

+ 

OH 

1 .30E+15 

0. 

105140 . 

THIRDBODY 









H2 

4 

. 00 

02 

1.5 


H20 

20.0 N2 


1 . 5 

END 










H 

+ 

0 


= OH 

+ 

M 

7 . 1E+18 

-1. 

0. 

M 

+ 

H2 


= H 

+ 

H 

2 . 2E+14 

0. 

96000. 

THIRDBODY 









H2 

4 

. 10 

02 

2.0 


H20 

15.0 N2 


2.0 

END 










M 

+ 

02 


- o 

+ 

O 

1 .80E+18 

*1 . 

118020 . 

HO 2 

+ 

NO 


= NO 2 

+ 

OH 

2 . 09E+12 

0. 

-477 . 

0 

+ 

NO 2 


= NO 

+ 

02 

1.0E+13 

0. 

596 . 

NO 

■f 

0 


= NO 2 

+ 

M 

5 . 62E+15 

0. 

-1160. 

NO 2 

+ 

H 


= NO 

+ 

OH 

3.47E+14 

0. 

1470. 

NO 

+ 

O 


= N 

♦ 

02 

3.8E+9 

1. 

41370 . 

O 

+ 

N2 


= NO 

■f 

N 

1.8E+14 

0. 

76250. 

NO 

+ 

H 


= N 

+ 

OH 

2.63E+14 

0 . 

50410. 

M 

+ 

N20 


= N2 

+ 

0 

6 . 92E+23 

-2.5 

65000. 

O 

+ 

N20 


= N2 

+ 

02 

1 . OE+14 

0. 

28020. 

O 

+ 

N20 


=2 . ONO 



6.92E+13 

0. 

26630 . 

N 

+ 

NO 2 


=2 . ONO 



4 . 0E+12 

0 . 

0 . 

N20 

+ 

H 


= N2 

+ 

OH 

7 . 59E+13 

0 . 

15100 . 

NO 2 

+ 

H2 


= HNO 2 

♦ 

H 

2.4E+13 

0 . 

29000 . 

OH 

+ 

N02 


= HNO 3 

+ 

M 

3 . 0E+ 15 

0 . 

-3800 . 

THIRDBODY 









02 

0 

.70 

H2 

1.4 


END 




OH 

+ 

NO 


= HNO 2 

+ 

M 

5 . 6E+15 

0 . 

-1700 . 

HNO 

+ 

H 


= H2 

+ 

NO 

5 . OE+12 

0 . 

0 . 

H 

+ 

NO 


= HNO 

+ 

M 

5 . 4E+15 

0 . 

-600 . 

HNO 

+ 

OH 


= H20 

+ 

NO 

3.6E+13 

0 . 

0 . 
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H2 


CO 2 AR 

DISTANCE AREA 
&prob 0X0=2000.0, print=3 . 048, 6 . 096,7 .620, 12 .19, 

htran=. true. , qmread= . true . , htl=5.863, ht0=-42.88, &end 
&start p=0 . 956 , t=1559.0, mach=5.0 / 

erat io=l . 0 , scc=0 . 0 , sch=2.0, scox=0.0, &end 

END 

&solver emax=5 . 0E - 3 , atolsp=l . 0E- 12 , &end 
FINIS 
LSENS 
CHANGE 


HYDROGEN - AIR TEST WITH HEAT TRANSFER 


FULL MECHANISM 


H02 

+ 

H02 


H202 4- 

02 

2 . 0E+12 

0. 

ADD 








O 

+ 

H202 

= 

OH + 

H02 

8 . 0E+13 

0 . 

END 








DISTANCE 

AREA FPS 



H2 



&prob exchr= 

= .true., print 

=0.1,0.2,0.25,0.4, &end 


&start 

p=2023 . 09 , t=2806. 

2 , mach=5 . 0 , 




flair s 

=0.029163, &end 





END 








Steolver 

&end 






FINIS 








LSENS 

HYDROGEN - OXYGEN 

CASE WITH HEAT TRANSFER 


NEW 








O 

+ 

H20 

= 

OH + 

OH 

6 . 8E+13 

0 . 

H 


02 

5! 

OH + 

O 

1 . 89E+14 

0 . 

0 

+ 

H2 

- 

OH + 

H 

4 .20E+14 

0 . 

H 

+ 

H02 

= 

H2 + 

02 

7 . 2 8E + 13 

0 . 

O 

+ 

HO 2 

= 

OH + 

02 

5 . OE+13 

0 . 

H02 

+ 

OH 

= 

H20 + 

02 

8.0E+12 

0 . 

H 

+ 

HO 2 

=2 . 

OOH 


1 . 34E+14 

0 . 

H2 

+ 

H02 

= 

H202 + 

H 

7 , 91E+13 

0. 

OH 

+ 

H202 

= 

H20 + 

H02 

6 . 1E+12 

0. 

H02 

+ 

HO 2 

= 

H202 + 

02 

1 . 8E+12 

0 . 

H 

+ 

H202 

= 

OH + 

H20 

7 . 8E+11 

0 . 

M 

+ 

H202 

=2 . 

OOH 


1 . 44 E+ 17 

0 . 

THIRDBODY 







H2 

2 . 

30 02 


.7 8 

H20 

6.0 H202 

END 








H2 

+ 

OH 

= 

H20 + 

H 

4 .74E+13 

0 . 

H 

♦ 

02 

= 

H02 + 

M 

1 .46E+15 

0 . 

THIRDBODY 







02 

1. 

30 H2 


3 . 0 

H20 

21.3 END 

M 

+ 

H20 

= 

H + 

OH 

1 . 30E+15 

0. 

THIRDBODY 







H2 

4. 

00 02 


1 . 5 

H20 

20.0 END 

H 

+ 

0 

= 

OH + 

M 

7 . 1E+18 

-1 . 

M 

+ 

H2 

= 

H + 

H 

2 . 2E+14 

0 . 

THIRDBODY 







H2 

4 . 

10 02 


2 . 0 

H20 

15.0 END 

M 

+ 

02 


O + 

O 

1 . 80E+18 

-1 . 

END 








DISTANCE 

PRESSURE 


FPS 

H2 



&prob cx0=5 . 

0, cxl= . 01 , print=10 .0,15 

. 0, 15 .95, 



htraiv 

= . true 

. , qmreads 

= . true . , htl=5 .863, ht0=-42 

.88, &end 


&8tart 

t=1050.0, mach= 

= 0.5 

, area=2000 . 

0, eratio=l 

. 0, 


8CC= 0 . 

0, sch=2.Q, scox=0 

.0, noxrat=0 

.0, arat=0.< 

0, crat=0.0 J 

, &end 

END 







&solver 

emax 

=5 . 0E- 6 , atolep=l . 0E- 13 , 

&end 



FINIS 








LSENS 

CH4 

- 02 - N2 

MECH . BATCH RXN 

. WITH OTTO 

CYCLE HEAT 

LOSS 

NEW 








M 

♦ 

CH4 

= 

CH3 + 

H 

2 . 0E+17 

0. 

H 

+ 

CH4 

= 

CH3 + 

H2 

1 . 26E+14 

0. 

CH4 

+ 

02 

= 

CH3 + 

H02 

7 . 94E+13 

0. 

O 

+ 

CH4 

= 

CH3 + 

OH 

1 .9E+14 

0 . 

OH 

+ 

CH4 

=* 

CH3 + 

H20 

2 . 5E+13 

0 . 

CH3 

+ 

02 

= 

CH30 + 

O 

2 . 4E+ 13 

0 . 

CH3 

+ 

OH 

= 

CH30 + 

H 

6 . 3E+ 12 

0 . 

M 

+ 

CH 30 

— 

CH20 + 

H 

5 . 0E+13 

0 . 

CH3 


CH3 

= 

C2H6 


2 . 4E + 14 

- .4 

H 

+ 

C2H6 

= 

C2H5 + 

H2 

1.32E+14 

0. 

O 

+ 

C2H6 

= 

C2H5 + 

OH 

1.13E+14 

0 . 

OH 

+ 

C2H6 

= 

C2H5 + 

H20 

8.7E+13 

0 . 

M 

+ 

C2H5 

= 

C2H4 + 

H 

1 .0E+17 

0 . 

C2H5 


02 

= 

C2H4 + 

H02 

2 . OE+12 

0 . 

H 

+ 

C2H5 

= 

C2H4 + 

H2 

4 . 8E+ 13 

0 . 

CH3 

+ 

CH2 

= 

C2H4 + 

H 

2. OE+13 

0 . 

H 

+ 

C2H4 

- 

H2 + 

C2H3 

1.5E+14 

0 . 


CASE 3 

0 . 


1000 . 


CASE 4 

18365 . 
16400 . 
13750 . 
2126 . 
1000 . 

0. 

107 0 . 
25000 . 
1430. 

0 . 

0 . 

45510 . 

6 . 6 

6098 . 
- 1000 . 


105140 . 


0 . 

96000 . 


118020 . 


CASE 5 

88000 . 
11900 . 
56000 . 
11720 . 
5010. 
28680 . 

0 . 

21000 . 

0 . 

9700 . 

7 850. 
3520 . 
31000. 
5000 . 

0 . 

0 . 

10200 . 
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M 

+ 

C2H4 

= C2H2 

4- 

H2 

2.6E+17 

0 . 

79300. 

C2H4 

+ 

OH 

= C2H3 

4- 

H20 

4 . 8E+12 

0. 

1230. 

C2H4 

-4 

OH 

= CH3 

+ 

CH20 

2 . OE+12 

0. 

960 . 

C2H4 

4 

O 

= CH3 

4- 

HCO 

3 . 3E+12 

0. 

1130. 

C2H4 

+ 

O 

= CH20 

+ 

CH2 

2 . 5E+13 

0. 

5000 . 

M 

4 

C2H3 

= C2H2 

4- 

H 

3 .0E4-15 

0. 

32000 . 

C2H3 

4 

02 

= CH20 

4- 

HCO 

3 . 98E+12 

0. 

-250 . 

C2H3 

+ 

H 

= C2H2 

4- 

H2 

6 .OE+12 

0 . 

0 . 

C2H3 

+ 

0 

= C2H20 

4- 

H 

3 . 3E+13 

0 . 

0 . 

C2H3 

+ 

OH 

= C2H2 

4- 

H20 

5 . OE+12 

0. 

0 . 

C2H3 

+ 

CH 2 

= C2H2 

4- 

CH3 

3 . OE+13 

0 . 

0 . 

C2H3 

+ 

C2H 

— 2 . 0C2H2 



3.0E+13 

0. 

0. 

M 

4 

C2H2 

= C2H 

4- 

H 

4 . 2E+16 

0. 

107000 

C2H2 

+ 

0 

= CH2 

4- 

CO 

1 .6E+14 

.0 

9890 . 

C2H2 

+ 

0 

= C2HO 

4- 

H 

4 . OE+14 

0.0 

10660 . 

C2H2 

♦ 

OH 

= C2H 

4- 

H20 

6 . 3E+ 12 

0.0 

7000 . 

C2H2 

4 

OH 

= C2H20 

4- 

H 

3 .2E4-11 

0.0 

200. 

C2H 

4 

02 

» C2HO 

4- 

0 

5 . 00E+-13 

0. 

1500. 

C2H 

4 

OH 

= C2HO 

4- 

H 

2 .OE+13 

0 . 

0 . 

C2HO 

+ 

02 

=2 . OCO 

4- 

OH 

1 .46E+12 

0. 

2500. 

C2HO 

4 

0 

—2 . OCO 

4- 

H 

1 .202E+12 

0. 

0 . 

C2HO 

+ 

OH 

—2 . OHCO 



1 .OE+13 

0. 

0 . 

C2HO 

4 

H 

= CH2 

4- 

CO 

5 .OE+13 

0. 

0. 

C2HO 

+ 

CH2 

~ C2H3 

4- 

CO 

3 . OE+13 

0. 

0 . 

C2H0 

4 

CH2 

= CH20 

4- 

C2H 

1 .OE+13 

0. 

2000 . 


2 . 

, OC2HO 

= C2H2 

+ 2 , 

.OCO 

1. OE+13 

0 . 

0. 

C2H20 

+ 

OH 

* CH20 

+ 

HCO 

2 . 8E+13 

0 . 

0. 

C2H20 

+ 

OH 

= C2H0 

+ 

H20 

7 . 5E+12 

0 . 

3000 . 

C2H20 

+ 

H 

= CH3 

4- 

CO 

1 .13E+13 

0. 

3428. 

C2H20 

+ 

H 

= C2H0 

+ 

H2 

7 . 5E+13 

0. 

8000. 

C2H20 

+ 

O 

“ C2H0 

4- 

OH 

5 . OE+13 

0. 

8000 . 

C2H20 

4 

O 

= CH20 

4- 

CO 

2 . OE+13 

0 . 

0 . 

M 

+ 

C2H20 

= CH2 

4- 

CO 

2 . OE+16 

0. 

60000 . 

C2H 

+ 

O 

= CO 

4- 

CH 

5 .OE+13 

0. 

0 . 

CH30 

+ 

02 

= CH20 

+ 

H02 

1. OE+13 

0. 

717 0 . 

CH30 

4 

H 

* CH20 

4“ 

H2 

2. OE+13 

0 . 

0 . 

M 

4 

CH20 

= HCO 

4“ 

H 

5 .OE+16 

0. 

81000 . 

CH20 

+ 

OH 

= HCO 

4 r 

H20 

3. OE+13 

0 . 

1200 . 

CH20 

+ 

H 

= HCO 

4- 

H2 

2.5E+13 

0. 

3990. 

CH20 

+ 

0 

= HCO 

4- 

OH 

3 . 5E+13 

0. 

3500. 

CH3 

+ 

CH20 

= CH4 

4- 

HCO 

1. 0E+10 

0.5 

6000 . 

CH3 

+ 

HCO 

= CH4 

4- 

CO 

3.0E+11 

.5 

0 . 

CH3 

+ 

H02 

= CH30 

4- 

OH 

2 .OE+13 

0. 

0 . 

M 

+ 

CH 3 

■ CH2 

4- 

H 

1 .95E+16 

0. 

91600 . 

H 

+ 

CH 3 

= H2 

4- 

CH2 

2 . 7 E+l 1 

.67 

25700 . 

O 

+ 

CH3 

= OH 

+ 

CH2 

1.9E+11 

.68 

25700 . 

OH 

+ 

CH3 

= H20 

+ 

CH2 

2 .7E+11 

.67 

25700 . 

CH 

+ 

C02 

= HCO 

4- 

CO 

3 .7 E+12 

0 . 

0 . 

CH 

+ 

02 

= HCO 

4- 

0 

1 .OE+13 

0 . 

0 . 

CH2 

+ 

02 

= CH20 

4- 

0 

5.0E+11 

0.5 

6960. 

CH2 

+ 

0 

= CH 

+ 

OH 

2.0E+11 

.7 

25800. 

CH2 

+ 

OH 

= CH 

+ 

H20 

5 . OE+11 

.5 

5900. 

CH2 

+ 

H 

= CH 

+ 

H2 

3.2E+11 

0.7 

4970. 

CH2 

+ 

CH2 

= C2H3 

+ 

H 

5 .OE+12 

0. 

0 . 

CH2 

4 

CH2 

= C2H2 

4- 

H2 

4 .OE+13 

0. 

0 . 

HCO 

+ 

02 

= CO 

4- 

H02 

3 .OE+13 

0. 

0 . 

HCO 

4 

O 

= CO 

4- 

OH 

3. OE+13 

0. 

0 . 

HCO 

4 

OH 

= CO 

4- 

H20 

3 .OE+13 

0. 

0 . 

HCO 

4 

H 

= CO 

4- 

H2 

2. OE+13 

0 . 

0 . 

M 

4 

HCO 

* H 

+ 

CO 

2 . 9E+14 

0. 

15570 . 

CO 

4 

O 

= CO 2 

4 

M 

2 . 4 E+l 5 

0 . 

4100 . 

CO 

4 

02 

= CO 2 

4 

O 

2 . 5E+12 

0. 

47690 . 

CO 

4 

OH 

= CO 2 

4 

H 

4 . 17E+11 

0. 

1000. 

CO 

4 

H02 

* CO 2 

4 

OH 

5 .7 5E + 13 

0. 

22930. 

o 

4 

H20 

= OH 

4 

OH 

6.8E+13 

0. 

18365 . 

H 

♦ 

02 

» OH 

4 

O 

1.89E+14 

0 . 

16400. 

o 

4 

H2 

= OH 

4 

H 

4 . 2 OE+14 

0. 

13750. 

H 

4 

HO 2 

= H2 

4 

02 

7 . 28E+13 

0. 

2126 . 

O 

+ 

H02 

= OH 

4 

02 

5 .OE+13 

0. 

1000. 

H02 

4 

OH 

= H20 

4 

02 

8. OE+12 

0. 

0 . 

H 

4 

H02 

=2 . OOH 



1 .34E+14 

0. 

107 0 . 

H2 

4 

H02 

= H202 

4 

H 

7 . 91E+13 

0. 

25000 . 

OH 

4 

H202 

= H20 

4 

HO 2 

6 . 1E+12 

0. 

1430 . 

H02 

4 

H02 

= H202 

4 

02 

1.8E+12 

0 . 

0 . 

H 

4 

H202 

= OH 

4 

H20 

7 . 8E+11 

0. 

0 . 

M 

+ 

H202 

=2 . OOH 



1.44E+17 

0. 

45510. 

THIRDBODY 









2 

.30 02 

.7 8 


H20 

6.0 H2Q2 

6 .6 

3 

H2 

+ 

OH 

« H20 

4 

H 

4 . 7 4E+1 3 

0. 

6098. 

H 

4- 

02 

= H02 

4 

M 

1.46E+15 

0 . 

-1000. 


THIRDBODY 
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02 

1 

.30 

N2 

1 . 3 


H20 

21.3 

CO 2 

7 . 0 

END 










M 

+ 

H20 

= 

H 

+ 

OH 

1 .30E+15 

0. 

10514 

THIRDBODY 









H2 

4 

. 00 

02 

1 . 5 


H20 

20.0 

N2 

1 . 5 

CO 2 

4 

. 0 

END 







H 

♦ 

O 

= 

OH 

+ 

M 

7 . 1E+18 

* 1 . 

0 . 

M 

+ 

H2 

= 

H 

+ 

H 

2 . 2E+14 

0 . 

9600i 

THIRDBODY 









H2 

4 , 

. 10 

02 

2 . 0 


H20 

15.0 

N2 

2 . 0 

END 










M 


02 

= 

O 

+ 

O 

1 . 80E+18 

1 . 

118021 

CH 


N2 

= 

HCN 

+ 

N 

1 -0E + 11 

0. 

19000 

CN 

+ 

H 2 

= 

HCN 

+ 

H 

6 . 0E+1 3 

0 . 

5300 . 

O 

+ 

HCN 

= 

OH 

+ 

CN 

1 .4E+11 

.68 

16900 

OH 

+ 

HCN 

= 

HNCO 

+ 

H 

4 . 0E+11 

0 . 

2800 

CN 

+ 

O 

= 

CO 

+ 

N 

1 .2E+13 

0. 

0 . 

CN 

+ 

OH 

= 

NCO 

+ 

H 

2 . 5E+14 

0 . 

6000 . 

H2 

+ 

NCO 

= 

HNCO 

+ 

H 

1.0E+14 

0. 

9000 . 

HNCO 

♦ 

H 

= 

NH2 

+ 

CO 

1.0E+14 

0 . 

8500 . 

CN 

+ 

02 

= 

NCO 

+ 

0 

3 . 2E+ 13 

0 . 

1000 . 

CN 

+ 

C02 

— 

NCO 

+ 

CO 

3 . 7 E> 12 

0 . 

0 . 

O 

+ 

NCO 

= 

NO 

+ 

CO 

2 . 0E+ 13 

0 . 

0 . 

N 

+ 

NCO 

= 

N2 

+ 

CO 

1 .0E+13 

0 . 

0 . 

H 

+ 

NCO 

= 

NH 

+ 

CO 

2 . 0E+13 

0 . 

0 . 

CH 

+ 

NO 

= 

N 

+ 

HCO 

1 .6E+13 

0. 

9940 . 

CH 

+ 

NO 

= 

O 

+ 

HCN 

2 . 0E+12 

0 . 

0 . 

NH 

+ 

OH 

= 

N 

+ 

H20 

5 . 0E+11 

0.5 

2000 . 

HO 2 

+ 

NO 

= 

N02 

+ 

OH 

2 . 09E+12 

0 . 

-477 . 

O 

+ 

NO 2 

= 

NO 

+ 

02 

1 . 0E+13 

0. 

596 . 

NO 

+ 

O 

= 

NO 2 

+ 

M 

5 . 62E+15 

0 . 

-1160 . 

NO 2 

+ 

H 

= 

NO 

+ 

OH 

3 . 47 E+14 

0, 

1470. 

NO 

+ 

H 

= 

N 

+ 

OH 

2 . 6 3E+14 

0 . 

50410 . 

NO 

+ 

O 

= 

N 

+ 

02 

3 . 8E+9 

1 . 

41370 , 

O 

+ 

N2 

= 

NO 

+ 

N 

1 .80E+14 

0 . 

76250 . 

N 

+ 

NO 2 

=2 

. ONO 



4 . OE+12 

0 . 

0. 

M 

+ 

N20 

= 

N2 

+ 

O 

6 . 92E+23 

-2.5 

65000 . 

O 

+ 

N20 

= 

N2 

+ 

02 

1 .OE+14 

0 . 

28020 . 

O 

+ 

N20 

= 2 

. ONO 



6 . 92E+1 3 

0 . 

26630 . 

N20 

+ 

H 

= 

N2 

+ 

OH 

7 .59E+13 

0. 

15100 . 

NO 2 

+ 

H2 

= 

HNO 2 

+ 

H 

2 . 4E+ 13 

0 . 

29000 . 

OH 

+ 

NO 2 

S3 

HN03 

+ 

M 

3 . 0E+ 15 

0 . 

-3800 . 

THIRDBODY 









02 

0 . 

70 

H2 

1.4 


END 




OH 

+ 

NO 

= 

HN02 

+ 

M 

5 . 6E+15 

0 . 

-1700 . 

HNO 

+ 

H 

= 

H2 

+ 

NO 

5. OE+12 

0 . 

0 . 

H 

+ 

NO 

= 

HNO 

+ 

M 

5.4E+15 

0 . 

-600 . 

HNO 

+ 

OH 

= 

H20 

+ 

NO 

3 . 6E+ 1 3 

0 . 

0 . 

END 










TIME 

PRESSURE 








&prob 

ct 0=2 . 

0, ctl 

=7 00.0 

, print=2 . 

5E* 

-4 , 3 . 4E- 

-4.3. 8E-4 , 



htran 

= . true 

• • / qmread= . false . , otto=. 

, true . , 

bore=8 . 5 . stroke=7.0. 


twall 

=1000 . 

0 , rpm 

=2500 . 

0 , &end 







&start 

CH4 

02 

N2 

N 

CH 

CN 

CH2 

END 

&solver 

FINIS 

LSENS 

NEW 

M 

H 

CH4 

0 

OH 

CH3 

CH3 

M 

CH3 

H 

O 

OH 

M 

C2H5 

H 


t=15 5 0 . 0 , &end 
0 .17 25 
0 . 1725 
0 . 65492 
0 . 00001 
0 . 00003 
0 . 00001 
0 . 00001 

emax= 1 . o E - 4 , atolsp=l . 0E- 13 , &end 

METHANE AIR MECHANISM CONSTANT PRESSURE FLOW PROBLEM 


CH4 

CH4 

02 

CH4 

CH4 

02 

OH 

CH 30 
CH3 
C2H6 
C2H6 
C2H6 
C2H5 
02 

C2H5 


CH3 

CH3 

CH3 

CH3 

CH3 

CH30 

CH30 

CH20 

C2H6 

C2H5 

C2H5 

C2H5 

C2H4 

C2H4 

C2H4 


H 

H2 

H02 

OH 

H20 

O 

H 

H 

H2 

OH 

H20 

H 

HO 2 
H2 


2 . 0E+17 
1 . 26E+ 14 
7 . 94 E+13 
1 . 9E+14 
2 . 5E+13 
2 . 4E+13 
6 . 3E+12 
5.0E+13 
2 . 4E+14 
1 .32E+14 
1 .13E+14 
8 . 7 E + 13 
1 . OE+17 
2 . OE+12 
4 . 8E+ 1 3 


0 . 
0. 

0 . 
0. 

0 . 
0. 
0 . 
0 . 

- .4 
0 . 

0 . 

0 . 

0 . 

0 . 

0 . 


CASE 6 

88000 . 
11900 . 
56000 . 
11720 . 
5010. 
28680 . 

0 . 

21000 . 

0 . 

97 00 . 
7850 . 
3520. 
31000 . 
5000 . 

0 . 


176 



CH3 

+ 

CH2 

= 

C2H4 

+ 

H 

2.0E+13 

0. 

0 . 

H 

+ 

C2H4 

= 

H2 

♦ 

C2H3 

1.5E+14 

0. 

10200 . 

M 

+ 

C2H4 

- 

C2H2 

+ 

H2 

2.6E+17 

0. 

79300 . 

C2H4 

+ 

OH 


C2H3 

+ 

H20 

4.8E+12 

0. 

1230. 

C2H4 

+ 

OH 

= 

CH3 

+ 

CH20 

2 . OE+12 

0 . 

960 . 

C2H4 

+ 

O 

= 

CH3 

+ 

HCO 

3 . 3E+12 

0 . 

1130. 

C2H4 

+ 

O 

- 

CH20 

+ 

CH2 

2 . 5E+13 

0 . 

5000 . 

M 

+ 

C2H3 

= 

C2H2 

+ 

H 

3 . OE+15 

0 . 

32000 . 

C2H3 

+ 

02 


CH20 

+ 

HCO 

3 . 98E+12 

0. 

-250 . 

C2H3 

+ 

H 

= 

C2H2 

+ 

H2 

6 .OE+12 

0 . 

0 . 

C2H3 

+ 

O 

ss 

C2H20 

+ 

H 

3 . 3E+13 

0 . 

0 . 

C2H3 

+ 

OH 

= 

C2H2 

+ 

H20 

5 . OE+12 

0 . 

0 . 

C2H3 

+ 

CH2 

= 

C2H2 

+ 

CH3 

3 . OE+13 

0 . 

0 . 

C2H3 

+ 

C2H 

= 2 

. 0C2H2 



3.0E+13 

0. 

0 . 

M 

+ 

C2H2 

= 

C2H 

+ 

H 

4 . 2E+16 

0. 

107000 

C2H2 

+ 

0 

- 

CH2 

+ 

CO 

1.6E+14 

.0 

9890. 

C2H2 

+ 

O 

= 

C2H0 

+ 

H 

4 . OE+14 

0.0 

10660. 

C2H2 

+ 

OH 

= 

C2H 

+ 

H20 

6.3E+12 

0.0 

7000 . 

C2H2 

+ 

OH 

= 

C2H20 

+ 

H 

3 ♦ 2E+11 

0.0 

200 . 

C2H 

+ 

02 

= 

C2H0 

+ 

0 

5 . OOE+13 

0. 

1500 . 

C2H 

+ 

OH 

= 

C2H0 

+ 

H 

2. OE+13 

0 . 

0. 

C2H0 

+ 

02 

=2 

. OCO 

+ 

OH 

1 .46E+12 

0. 

2500 . 

C2H0 

+ 

0 

= 2 

.oco 

+ 

H 

1 .202E+12 

0 . 

0. 

C2HO 

+ 

OH 

=2 

. OHCO 



1. OE+13 

0. 

0 . 

C2H0 

+ 

H 

= 

CH2 

+ 

CO 

5 .OE+13 

0 . 

0 . 

C2H0 

+ 

CH2 

= 

C2H3 

+ 

CO 

3 . OE+13 

0. 

0. 

C2H0 

+ 

CH2 

= 

CH20 

+ 

C2H 

1 . OE+13 

0. 

2000. 


2 

. OC2HO 

- 

C2H2 

+ 2 . 

.OCO 

1. OE+13 

0 . 

0. 

C2H20 

+ 

OH 

= 

CH20 

+ 

HCO 

2 . 8E+13 

0 . 

0 . 

C2H20 

+ 

OH 

= 

C2H0 

+ 

H20 

7 . 5E+12 

0 . 

3000 . 

C2H20 

+ 

H 

SS 

CH3 

+ 

CO 

1 -13E+13 

0. 

3428 . 

C2H20 

+ 

H 

= 

C2H0 

+ 

H2 

7 .5E+13 

0. 

8000 . 

C2H20 

+ 

O 

= 

C2H0 

+ 

OH 

5 .OE+13 

0. 

8000 . 

C2H20 

+ 

O 

- 

CH20 

+ 

CO 

2 -OE+13 

0. 

0. 

M 

♦ 

C2H20 

- 

CH2 

+ 

CO 

2.0E+16 

0. 

60000 . 

C2H 

+ 

0 

= 

CO 

+ 

CH 

5. OE+13 

0. 

0 . 

CH30 

+ 

02 

= 

CH20 

+ 

H02 

1 . OE+13 

0. 

717 0 . 

CH30 

+ 

H 

= 

CH20 

+ 

H2 

2 -OE+13 

0. 

0 - 

M 

+ 

CH 20 

SS 

HCO 

+ 

H 

5.0E+16 

0- 

81000 . 

CH20 

+ 

OH 

SS 

HCO 

+ 

H20 

3. OE+13 

0. 

1200 . 

CH20 

+ 

H 

= 

HCO 

+ 

H2 

2.5E+13 

0. 

3990 . 

CH20 

+ 

O 

= 

HCO 

+ 

OH 

3 -5E+13 

0. 

3510 . 

CH3 

+ 

CH20 

SS 

CH4 

+ 

HCO 

1.0E+10 

0.5 

6000. 

CH3 

+ 

HCO 

= 

CH4 

+ 

CO 

3 -OE+11 

.5 

0 . 

CH3 

+ 

H02 

= 

CH30 

+ 

OH 

2 -OE+13 

0. 

0 . 

M 

+ 

CH3 

SS 

CH2 

+ 

H 

1 -95E+16 

0. 

91600 . 

H 

+ 

CH3 

SS 

H2 

+ 

CH2 

2.7E+11 

.67 

25700 . 

0 

+ 

CH3 

= 

OH 

+ 

CH2 

1.9E+11 

.68 

25700 . 

OH 

+ 

CH3 

= 

H20 

+ 

CH2 

2.7E+11 

.67 

25700. 

CH 

+ 

CO 2 

= 

HCO 

+ 

CO 

3 -7E+12 

0. 

0. 

CH 

+ 

02 

= 

HCO 

+ 

0 

1 -OE+13 

0. 

0 . 

CH2 

+ 

02 

= 

CH20 

+ 

0 

5 -OE+11 

0.5 

6960 . 

CH2 

+ 

O 

= 

CH 

+ 

OH 

2. OE+11 

.7 

25800 . 

CH2 

+ 

OH 


CH 

+ 

H20 

5 -OE+11 

.5 

5900 . 

CH2 

+ 

H 

= 

CH 

+ 

H2 

3 -2E+11 

0.7 

4970 . 

CH2 

+ 

CH2 

= 

C2H3 

+ 

H 

5 -OE+12 

0. 

0 . 

CH2 

+ 

CH2 

= 

C2H2 

+ 

H2 

4 -OE+13 

0. 

0 . 

HCO 

+ 

02 

= 

CO 

+ 

HO 2 

3 - OE+13 

0. 

0 . 

HCO 

+ 

0 

= 

CO 

+ 

OH 

3 -OE+13 

0. 

0. 

HCO 

+ 

OH 

=5 

CO 

+ 

H20 

3 -OE+13 

0 . 

0 . 

HCO 

+ 

H 

SS 

CO 

+ 

H2 

2. OE+13 

0. 

0 . 

M 

+ 

HCO 

= 

H 

+ 

CO 

2 -9E+14 

0 . 

15570- 

CO 

+ 

0 

= 

CO 2 

+ 

M 

2 -4E+15 

0 . 

4100. 

CO 

+ 

02 

= 

CO 2 

+ 

0 

2.5E+12 

0. 

47690. 

CO 

+ 

OH 

- 

CO 2 

+ 

H 

4 -17E+11 

0. 

1000. 

CO 

+ 

H02 

= 

CO 2 

+ 

OH 

5 -75E+13 

0. 

22930. 

0 

+ 

H20 

= 

OH 

+ 

OH 

6 -8E+13 

0 . 

18365 . 

H 

+ 

02 

= 

OH 

+ 

0 

1 -89E+14 

0 . 

16400. 

o 

+ 

H2 

= 

OH 

+ 

H 

4 -20E+14 

0 . 

13750. 

H 

+ 

HO 2 

= 

H2 

+ 

02 

7 -28E+13 

0. 

2126 . 

O 

+ 

H02 

- 

OH 

+ 

02 

5. OE+13 

0. 

1000 . 

HO 2 

+ 

OH 

SS 

H20 

♦ 

02 

8. OE+12 

0. 

0. 

H 

+ 

H02 

=2 , 

. OOH 



1 -34E+14 

0. 

1070 . 

H2 

+ 

H02 

= 

H202 

+ 

H 

7 -91E+13 

0. 

25000. 

OH 

+ 

H202 

= 

H20 

+ 

H02 

6.1E+12 

0 . 

1430. 

H02 

+ 

HO 2 

= 

H202 

♦ 

02 

1.8E+12 

0. 

0 . 

H 

+• 

H202 

- 

OH 


H20 

7 .8E+11 

0. 

0. 

M 

+ 

H202 

=2 . 

. OOH 



1 -44E+17 

0. 

45510. 

THIRDBODY 










2 . 

.30 02 


.7 8 


H20 

6.0 H202 

6.6 

H2 

+ 

OH 

= 

H20 

+ 

H 

4 . 7 4E+ 1 3 

0 . 

6098 . 
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H 

+ 

02 


- 

H02 

+ 

M 

1 .46E + 15 

0 . 

-1000. 

THIRDBODY 










02 

1. 

. 30 

N2 


1 . 3 


H20 

21.3 CO 2 

7 .0 

END 











M 

+ 

H20 



H 

+ 

OH 

1 .30E+15 

0 . 

105140 

THIRDBODY 










H2 

4 

. 00 

02 


1 . 5 


H20 

20.0 N2 


1 . 5 

CO 2 

4 

. 0 

END 








H 

+ 

O 



OH 

+ 

M 

7 . 1E+18 

-1 . 

0 . 

M 


H2 


= 

H 

+ 

H 

2 . 2E+14 

0 . 

96000 

THIRDBODY 










H2 

4 

. 10 

02 


2 . 0 


H20 

15.0 N2 


2 . 0 

END 











M 

+ 

02 


= 

O 

+ 

O 

1 . 80E+18 

-1 . 

118020 

CH 

+ 

N2 


= 

HCN 

+ 

N 

1 .0E+11 

0 . 

19000. 

CN 

+ 

H2 


- 

HCN 

+ 

H 

6 .0E+13 

0 . 

5300. 

O 

+ 

HCN 


- 

OH 

+ 

CN 

1 .4E+11 

.68 

16900 . 

OH 

+ 

HCN 


= 

HNCO 

+ 

H 

4 . 0E+11 

0 . 

2800 . 

CN 

♦ 

O 


= 

CO 

+ 

N 

1 . 2E+13 

0 . 

0. 

CN 

+ 

OH 



NCO 

+ 

H 

2 . 5E+14 

0 . 

6000 . 

H2 

+ 

NCO 


- 

HNCO 

+ 

H 

1 . 0E+14 

0 . 

9000 . 

HNCO 

+ 

H 



NH2 

+ 

CO 

1 .OE+14 

0 . 

8500 . 

CN 

+ 

02 


- 

NCO 

+ 

O 

3 . 2E+13 

0 . 

1000 . 

CN 

+ 

C02 


= 

NCO 

+ 

CO 

3 . 7 E+12 

0 . 

0 . 

O 

+ 

NCO 


= 

NO 

+ 

CO 

2 . OE+13 

0 . 

0 . 

N 

+ 

NCO 


= 

N2 

+ 

CO 

1 . OE+13 

0 . 

0 . 

H 

+ 

NCO 


= 

NH 

+ 

CO 

2 . OE+13 

0 . 

0 . 

CH 

+ 

NO 


- 

N 

+ 

HCO 

1.6E+13 

0 . 

9940 . 

CH 

+ 

NO 


= 

O 

+ 

HCN 

2 . 0E+12 

0 . 

0. 

NH 

+ 

OH 



N 

+ 

H20 

5 . 0E+11 

0 . 5 

2000 . 

H02 

+ 

NO 



NO 2 

+ 

OH 

2 . 09E + 12 

0 . 

-477 . 

O 

+ 

NO 2 


= 

NO 

+ 

02 

1 .OE+13 

0 . 

596 . 

NO 

+ 

O 


= 

NO 2 

+ 

M 

5 .62E+15 

0 . 

- 1160 . 

NO 2 

+ 

H 


= 

NO 

+ 

OH 

3 . 47 E+l 4 

0 . 

1470 . 

NO 

+ 

H 


= 

N 

+ 

OH 

2 . 63E+14 

0 . 

50410 . 

NO 

+ 

O 


ss 

N 

+ 

02 

3 . 8E+9 

1 . 

41370 . 

O 

+ 

N2 


— 

NO 

+ 

N 

1 . 80E+14 

0 . 

76250 . 

N 

+ 

NO 2 


= 2 , 

. ONO 



4 . 0E+12 

0 . 

0 . 

M 

+ 

N20 


* 

N2 

+ 

O 

6.92E+23 

-2.5 

65000 . 

O 

+ 

N20 


as 

N2 

+ 

02 

1 .OE+14 

0 . 

28020 . 

O 

+ 

N20 


—2 . 

. ONO 



6 . 92E+1 3 

0 . 

26630 . 

N20 

+ 

H 



N2 

+ 

OH 

7 . 59E+1 3 

0 . 

15100 . 

NO 2 

+ 

H2 


= 

HNO 2 

+ 

H 

2 . 4E+13 

0. 

29000 . 

OH 

+ 

N02 


= 

HN03 

+ 

M 

3 . 0E+15 

0 . 

-3800 . 

THIRDBODY 










02 

0 

.70 

H2 


1.4 


END 




OH 

+ 

NO 


as 

HN02 

+ 

M 

5 . 6E+1 5 

0. 

-1700 . 

HNO 

+ 

H 


= 

H2 

+ 

NO 

5 . 0E+12 

0 . 

0 . 

H 

+ 

NO 


= 

HNO 

+ 

M 

5 . 4E + 15 

0 . 

-600 . 

HNO 

+ 

OH 


= 

H20 

+ 

NO 

3 . 6E+13 

0 . 

0 . 


END 

DISTANCE PRESSURE 

&prob cxO^I .730, combus= . true . , exchr= . true . , 

print=10 .0,20. 0,25. 0,30,0,32. 0,34. 0,36. 0,37. 0,38. 0,39. 0,40. 0,41.0, 

42. 0,43. 0,44. 0,45. 0,46. 0,47. 0,48.0, &end 


&start 

area=1000 . o. 

mach=2.0, t=1700.0, &end 

CH4 

0 . 049768 


02 

0. 199072 


N2 

0 .75116 


CN 

0. 0000001 


END 

fcsolver 

emax=l . 0E- 4 , 

, atolsp=l . 0E - 10 , &end 


FINIS 

LSENS METHANE - AIR WITH AREA PROFILE OF CASE 6 CASE 7 

REPEAT 

DISTANCE AREA 

&prob pcon= . false . , combus= . false . , 

Xtb=0 .0,10.0,20.0,25.0,30.0,32.0,34.0,36.0,37.0,38.0,39.0,40.0,41.0, 

42. 0. 43. 0.44. 0.45. 0.46. 0.47. 0.48.0, 

atb= 1000.00,1000.20, 1004 .65, 1010. 85, 1023. 22, 103 1.44, 104 2. 92, 105 9. 73, 

1071 .45 , 1087 . 06 , 1110 . 03, 1153 .7 5, 12 84 . 24 , 1350 .79 , 137 6 . 81, 1397 .15, 

1414.00. 1428.05.1439. 83.1449 .81, 
aprint=1023 .22, 1153 .75, 1439.83, &end 

&start t=17 00.0, mach=2.0, p=1.7 30, tend 
CH4 0.049768 

02 0.199072 

N2 0.75116 

CN 0.0000001 

END 

isolver emax=5 . 0E- 5 , atolsp=l . 0E- 13 , &end 
FINIS 
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LSENS METHANE - AIR WITH AREA AND TEMPERATURE PROFILES OF CASE 6 CASE 8 

REPEAT 

DISTANCE AREA 
tprob tass=.true., tend 

ttmpdat xtb=0 .0,15. 0,20. 0,25. 0,30. 0,32. 0,34. 0,36. 0,38. 0,40. 0,41.0, 

42. 0,43. 0,44. 0,45. 0,46. 0,47. 0,48.0, 
tmptb=17 00.00, 17 02. 50, 17 07. 74, 17 18. 03, 17 38. 22, 17 51. 43, 17 69. 70, 

17 96 . 16, 183 8 .63 , 19 39 .65, 2127 . 05, 2 2 25 . 54 , 2 27 0 .46 , 2307 .7 1,2 339 . 56, 

2366. 73, 2389. 90, 24 09. 76, 
tprint=1738 . 22, 1939 .65, 2389 .90, tend 
tstart p— 1 .730, mach=2.0, tend 
CH4 0.049768 

02 0.199072 

M2 0.75116 

CN 0.0000001 

END 

tsolver emax=1.0E-3, atolsp=l . 0E- 12 , mf=21, tend 
FINIS 

LSENS METHANE AIR MECHANISM ASSIGNED (CONST.) TEMP. FLOW PROBLEM CASE 9 
REPEAT 

DISTANCE PRESSURE 

tprob cx0=l .730, combus= . true . , exchr= . false . , 
print=25 . 0, 42 .0,48 .0, tend 
ttmpdat cx0=17 00.0, tend 
tstart area=1000.0, mach=2.0, tend 
CH4 0.049768 

02 0.199072 

N2 0.75116 

CN 0.0000001 

END 


tsolver 

emax : 

=1 . 0E-4 

, atolsp=1.0E- 

13 , 

tend 




FINIS 










LSENS 

METHANOL - 

AIR COMBUSTION 




CASE 10 

NEW 










M 

+ 

CH30H 

= 

CH3 

+ 

OH 

3 . 2E+18 

0 . 

80000 . 

02 

+ 

CH30H 

= 

CH20H 

+ 

H02 

4 . 0E+13 

0 . 

50900 . 

OH 

+ 

CH30H 

= 

CH20H 

+ 

H20 

4 . OE+12 

0 . 

2000 . 

O 

+ 

CH30H 

= 

CH20H 

+ 

OH 

1 . 6E+12 

0. 

2300 . 

H 

+ 

CH30H 

= 

CH20H 

+ 

H2 

3 . 2E+13 

0. 

7000 . 

H 

+ 

CH30H 

= 

CH3 

+ 

H20 

5 . OE+12 

0. 

5300 . 

CH3 

+ 

CH30H 

= 

CH20H 

+ 

CH4 

2 . OE+11 

0. 

9800. 

H02 

+ 

CH30H 

= 

CH20H 

+ 

H202 

6 . 3E+12 

0. 

19400 . 

M 

+ 

CH20H 

= 

CH20 

+ 

H 

2 . 5E+13 

0. 

29000. 

02 

+ 

CH20H 

SB 

CH20 


H02 

1 .OE+12 

0. 

6000 . 

M 

+ 

CH4 

= 

CH3 

+ 

H 

2 . 0E+17 

0. 

88000 . 

H 

+ 

CH4 

= 

CH3 

+ 

H2 

1.26E+14 

0. 

11900 . 

CH4 

+ 

02 


CH3 

+ 

H02 

7 . 94E+13 

0. 

56000. 

O 

+ 

CH4 

= 

CH3 

+ 

OH 

1 .9E+14 

0 . 

11720. 

OH 

+ 

CH4 

ss 

CH3 

+ 

H20 

2 . 5E+13 

0. 

5010. 

CH3 

+ 

02 

= 

CH 30 

+ 

O 

2 . 4E+13 

0. 

28680. 

CH3 

+ 

OH 

= 

CH 30 

+ 

H 

6 . 3E+12 

0. 

0 . 

M 

+ 

CH30 

= 

CH20 

+ 

H 

5 . 0E+13 

0. 

21000. 

CH3 

+ 

CH3 

= 

C2H6 



2 . 4E+14 

- .4 

0. 

H 

+ 

C2H6 

= 

C2H5 

+ 

H2 

1.32E+14 

0. 

9700 . 

O 

+ 

C2H6 

= 

C2H5 

+ 

OH 

1.13E+14 

0. 

7850 . 

OH 

+ 

C2H6 

- 

C2H5 

+ 

H20 

8.7E+13 

0. 

3520. 

M 

+ 

C2H5 

= 

C2H4 

+ 

H 

1.0E+17 

0. 

31000. 

C2H5 

+ 

02 

* 

C2H4 

+ 

H02 

2. OE+12 

0. 

5000. 

H 

+ 

C2H5 

- 

C2H4 

+ 

H2 

4 . 8E+13 

0. 

0 . 

CH3 

+ 

CH2 

= 

C2H4 

+ 

H 

2 . OE+13 

0 . 

0 . 

H 

+ 

C2H4 


H2 

+ 

C2H3 

1 .5E+14 

0. 

10200. 

M 

+ 

C2H4 

= 

C2H2 

+ 

H2 

2 . 6E+17 

0. 

79300. 

C2H4 

+ 

OH 

= 

C2H3 

+ 

H20 

4.8E+12 

0. 

1230. 

C2H4 

+ 

OH 

= 

CH3 

+ 

CH20 

2 . OE+12 

0. 

960. 

C2H4 

+ 

O 

= 

CH3 

+ 

HCO 

3 . 3E+12 

0. 

1130. 

C2H4 

+ 

0 

= 

CH20 

+ 

CH2 

2 . 5E+13 

0. 

5000 . 

M 

+ 

C2H3 

- 

C2H2 

+ 

H 

3 . OE+15 

0. 

32000. 

C2H3 

+ 

02 

= 

CH20 

+ 

HCO 

3.98E+12 

0. 

-250. 

C2H3 

+ 

H 

= 

C2H2 

+ 

H2 

6 .OE+12 

0. 

0. 

C2H3 

+ 

O 

~ 

C2H20 

+ 

H 

3 . 3E+13 

0 . 

0 . 

C2H3 


OH 

- 

C2H2 

+ 

H20 

5 . OE+12 

0. 

0 . 

C2H3 

+ 

CH2 

= 

C2H2 

+ 

CH3 

3 .OE+13 

0. 

0 . 

C2H3 

+ 

C2H 

=2 

. 0C2H2 



3 . OE+13 

0. 

0 . 

M 

+ 

C2H2 

= 

C2H 

+ 

H 

4 . 2E+16 

0 . 

107000 . 

C2H2 

+ 

O 

= 

CH2 

+ 

CO 

1 .6E+14 

. 0 

9890 . 

C2H2 

+ 

O 


C2HO 

+ 

H 

4 . 0E+ 14 

0.0 

10660 . 

C2H2 


OH 

- 

C2H 

+ 

H20 

6 . 3E+12 

0.0 

7000 . 

C2H2 

+ 

OH 

= 

C2H20 

+ 

H 

3 . 2E+11 

0 . 0 

200. 

C2H 

+ 

02 

= 
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OH 

+ 

H 

4 . 20E+14 

0 . 

13750 . 

H 

4 

HO 2 

=S 

H2 

+ 

02 

7 . 28E+13 

0 . 

2126 . 

0 

4 

H02 


OH 

+ 

02 

5 .OE+13 

0. 

1000 . 

HO 2 

4 

OH 

= 

H20 

+ 

02 

8 .OE+12 


0 . 

H 

4 

H02 

=2 . 

OOH 



1 . 34E+14 

0 . 

107 0 . 

H2 

4 

H02 

= 

H202 

+ 

H 

7 . 91E + 13 

0 . 

25000 . 

OH 

4 

H202 

= 

H20 

+ 

H02 

6 .1E+12 

0 . 

1430 . 

HO 2 

4 

HO 2 

= 

H202 

+ 

02 

1 . 8E+12 

0 . 

0 . 

H 

4 

H202 

= 

OH 

+ 

H20 

7 . 8E+11 

0. 

0 . 

M 

+ 

H202 

=2 . 

OOH 



1 -44E+17 

0 . 

45510 . 

THIRDBODY 









H2 

2 . 

30 02 


.78 


H20 

6.0 H202 

6 . 6 

END 










H2 

+ 

OH 

= 

H20 

+ 

H 

4 . 74E+13 

0. 

6098 . 

H 

+ 

02 

= 

HO 2 

+ 

M 

1 .46E+15 

0. 

- 1000 . 

THIRDBODY 









02 

1 . 

30 N2 


1.3 


H20 

21.3 C02 

7 . 0 

END 










M 

+ 

H20 

*= 

H 

+ 

OH 

1. 30E+15 

0 . 

10514 0 

THIRDBODY 









H2 

4 . 

00 02 


1.5 


H20 

20.0 N2 


1 . 5 

CO 2 

4 . 

0 END 








H 

4 

0 

= 

OH 

+ 

M 

7 . 1E+18 

-1 . 

0 . 

M 

+ 

H2 

— 

H 

+ 

H 

2.2E+14 

0. 

96000 

THIRDBODY 









H2 

4 . 

10 02 


2 . 0 


H20 

15.0 N2 


2 . 0 

END 










M 

+ 

02 

= 

0 

+ 

0 

1 . 80E+18 

'1 . 

118020 

CH 

+ 

N2 

= 

HCN 

+ 

N 

1 .OE+ll 

0 . 

19000 . 

CN 

+ 

H2 

= 

HCN 


H 

6 . OE+13 

0 . 

5300 . 

O 

+ 

HCN 

— 

OH 

+ 

CN 

1.4E+11 

68 

16900 . 

OH 

4 

HCN 

— 

HNCO 

+ 

H 

4 . OE+ll 

0 . 

2800 . 

CN 

4 

O 

= 

CO 

+ 

N 

1 . 2E+13 

0 . 

0 . 

CN 

4 

OH 

- 

NCO 

+ 

H 

2 . 5 E+l 4 

0 . 

6000 . 

H2 

+ 

NCO 

= 

HNCO 

+ 

H 

1 . OE+14 

0 . 

9000 . 

HNCO 

+ 

H 

= 

NH2 

4 

CO 

1 .OE+14 

0 . 

8500 . 

CN 

4- 

02 

= 

NCO 

4 

o 

3 . 2E+13 

0 . 

1000 . 
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CN 

+ 

C02 

= 

NCO 

+ 

CO 

3 . 7 E+12 

0. 

0 . 

O 

+ 

NCO 

= 

NO 

+ 

CO 

2.0E+13 

0 . 

0 . 

N 

+ 

NCO 

= 

N2 

+ 

CO 

1 . 0E+13 

0. 

0 . 

H 

+ 

NCO 

= 

NH 

+ 

CO 

2.0E+13 

0. 

0 . 

CH 

+ 

NO 

= 

N 

+ 

HCO 

1.6E+13 

0 . 

9940 . 

CH 

+ 

NO 

= 

O 

+ 

HCN 

2 . OE+12 

0. 

0 . 

NH 

+ 

OH 

= 

N 

+ 

H20 

5.0E+11 

0 . 5 

2000 . 

H02 

+ 

NO 

= 

NO 2 

+ 

OH 

2 . 09E+12 

0. 

-477 . 

O 

+ 

NO 2 

= 

NO 

+ 

02 

1.0E+13 

0. 

596 . 

NO 

+ 

O 

- 

NO 2 

+ 

M 

5 . 62E+15 

0 . 

-1160 

NO 2 

+ 

H 

= 

NO 

+ 

OH 

3 .47E+14 

0. 

1470 

NO 

+ 

H 

= 

N 

+ 

OH 

2 . 63E+14 

0 . 

50410 

NO 

+ 

O 

= 

N 

+ 

02 

3.8E+9 

1 . 

41370 

O 

+ 

N2 

= 

NO 

+ 

N 

1 .80E+14 

0 . 

76250 

N 

+ 

NO 2 

= 2 . 

. ONO 



4 .OE+12 

0 . 

0 . 

M 

+ 

N20 

= 

N2 

+ 

O 

6 . 9 2E+2 3 

-2.5 

65000 

O 

+ 

N20 

= 

N2 

+ 

02 

1.0E+14 

0. 

28020 

O 

+ 

N20 

=2 

. ONO 



6 . 92E+1 3 

0 . 

26630 

N20 

+ 

H 

as 

N2 

+ 

OH 

7 . 59E+13 

0. 

15100 

NO 2 

+ 

H2 

ss 

HN02 

+ 

H 

2.4E+13 

0. 

29000 

OH 

+ 

N02 

= 

HNO 3 


M 

3.0E+15 

0. 

-3800 

THIRDBODY 










0. 

.70 H2 


1 . 

.4 

END 




OH 

+ 

NO 

= 

HNO 2 

+ 

M 

5.6E+15 

0. 

-17 00 

HNO 

+ 

H 

= 

H2 


NO 

5 .OE+12 

0. 

0. 

H 

+ 

NO 

= 

HNO 

+ 

M 

5 . 4E+15 

0 . 

-600 . 

HNO 

+ 

OH 

= 

H20 

+ 

NO 

3 . 6E+13 

0. 

0 . 


AR 

DISTANCE AREA 

&prob welstr= . true . , conc= . false . , wsf low= . true . , 

cx0=15.0, 0x1=20.0, print=0 . 4 , 2 . 0, 4 . 0, rocket = . true . , htran= 
htl=0 . 05 , ht0= -42.88, pc= 7 3 . 5 , athrot=2 . 3 25 , &end 
&wsprob dotmax=1600 . 0, delmd=800.0, mpr=l, volume=300 . 0, 
wsrhtr= . true . , wsrhtl=0.05, wsrht0=-42 . 88 , tend 


.true . , 


&start 
C3H8 
N2 
02 
AR 
CO 2 
END 

&sol ver 
FINIS 
LSENS 
NEW 


t=6 14 . 0 , p=5 . 0 , mdot=10.0, molef =. false . , 
0.0873262 
0 .6892887 
0 . 211232 
0 . 011737 
0 . 0004162 


emax=1.0E-4, atolep=l . 0E- 13 , &end 
HIGH TEMPERATURE AIR IONIZATION 


x=0 . 2 , 


tend 


CASE 12 


N 

+ 

02 


= 

NO 

+ 

O 

6 . 4E+09 

1. 

6250 . 

O 

+ 

N2 


ss 

NO 

+ 

N 

1 .8E+14 

0. 

76250 

N 

+ 

O 


- 

NO 

+ 

M 

6 . 40E+16 

-0.5 

0 . 

THIRDBODY 










N20 

2 

.25 

END 








O 

+ 

0 


= 

02 

+ 

M 

5 . 7 E+13 

0. 

- 1790 

M 

+ 

N2 


= 

N 

+ 

N 

3 . 7 2E+21 

-1.6 

225000 

NO 

+ 

O 


- 

NO 2 

+ 

M 

5 . 62E+15 

0. 

-1160 

THIRDBODY 










N2 

1 

. 55 

END 








M 

+ 

N20 


= 

N2 

+ 

O 

6 . 92E+23 

-2.5 

65000 

O 

+ 

N20 


ss 

N2 

+ 

02 

1 .0E+14 

0. 

28020 

NO + 

+ 

E 


= 

N 

> 

O 

1 .45E+21 

-1.5 

0. 

0+ 

+ 

E 


= 

O 

+ 

M 

2 . 00E+26 

-2.5 

0. 

THIRDBODY 










02 

4 . 

50 

N 


0 . 

. 03 

NO 

50.0 O 


. 03 

END 











02 

+ 

E 


= 

02 - 

+ 

M 

1 .52E+21 

-1 . 

1190. 

THIRDBODY 










N2 

. 00002 

END 








02 

+ 

o- 


= 

02- 

•f 

O 

6 . 00E+12 

0. 

0 . 


END 

DISTANCE AREA 

&prob cx0=1000.0, dbugo= . true . , order= . true . , 
print=0 . 06 , 0 . 50 , 0 . 7 0 , &end 
&8tart p= 1 .6803, v=47002.0, t=4820.0, &end 
N2 0.7905 

02 0.2095 

02 - 0.000000001 


END 

&solver emax=1.0E-3, atolep=l . 0E- 12 , &end 
FINIS 

LSENS HIGH PRESSURE HYDROGEN - CARBON MONOXIDE REACTION 
NEW 

CH3 + OH = CH30 + H 6.3E+12 


0 . 


CASE 13 
0 . 


183 




H2 


M + 

CH30 + 

CH3 + 

CH3 + 

M 

H + 

OH + 

CH20 + 

CH20 + 

M + 

HCO + 

HCO + 

M + 

CO + 

CO + 

H + 

H2 + 

OH + 

M + 

THIRDBODY 

2 

H2 + 

M + 

THIRDBODY 


H2 4 

M + 

THIRDBODY 
H2 4 , 


CH 30 

H 

HCO 

H02 

CH4 

CH4 

CH4 

H 

OH 

CH 20 

H 

OH 
HCO 
OH 
H02 
HO 2 
HO 2 
H202 
H202 

. 30 
OH 
H20 

. 00 
H2 


=2 . 


H202 


CO 2 


CH20 

+ 

H 

CH20 

+ 

H2 

CH4 

+ 

CO 

CH30 

+ 

OH 

CH3 

+ 

H 

CH3 

+ 

H2 

CH3 

♦ 

H20 

HCO 

+ 

H2 

HCO 

+ 

H20 

H 

+ 

HCO 

CO 

+ 

H2 

CO 

+ 

H20 

H 

+ 

CO 

CO 2 

+ 

H 

CO 2 

+ 

OH 

DOH 

H202 

+ 

H 

H20 

+ 

HO 2 

30H 

6 

.6 

H20 

H20 

+ 

H 

H 

+ 

OH 

4 

. 0 

H20 

H 

+ 

H 


5. 0E+13 

0 . 

21000 . 

2 . OE+13 

0 . 

0 . 

3.0E+11 

. 5 

0 . 

2 .0E+13 

0. 

0 . 

2 . OE + 17 

0 . 

88000 . 

1 . 26E+14 

0 . 

11900 . 

2 . 5E+13 

0 . 

5010 . 

2.5E+13 

0 . 

3990 . 

3 . OE+13 

0 . 

1200. 

5 . OE+16 

0 . 

81000 . 

2 . OE+13 

0 . 

0 . 

3 .OE+13 

0 . 

0 . 

2 . 9E+14 

0 . 

15570 . 

4.17E+11 

0.0 

1000 . 

5 .7 5E + 13 

0 . 

22930. 

1.34E+14 

0 . 

1070 . 

7 . 91E+13 

0 . 

25000 . 

6.1E+12 

0 . 

1430 . 

1 . 44E+17 

0. 

45510 . 

6 . 0 END 


4 . 7 4E + 1 3 

0 . 

6098 . 

1 .30E+15 

0 . 

105140 

20.0 END 


2 . 2E+14 

0 . 

96000 


10 


H20 


15 . 0 


END 


END 

TIME 

&prob print =1 .0,1 . E+6 , 1 . E+8 , l . E+9 , combus= . true 
rhocon^ . true . , tcon= . true . , &end 
&etart t=!000.0, p=l0O.0, &end 
0 . 99 
0 . 01 


H2 
CO 
END 

&solver 
FINIS 
LSENS 
NEW 

O + 

H + 

0 + 

H + 

0 + 

H02 + 

H + 

H2 + 

OH + 

H02 + 

H + 

M + 

THIRDBODY 
H2 2 

END 


emax^l . 0E- 3 , atolsp=l . 0E- 12 , &end 

HYDROGEN - OXYGEN LOW TEMPERATURE PHOTOLYTIC IGNITION 


H20 
02 
H2 
HO 2 
HO 2 
OH 
HO 2 
H02 
H202 
HO 2 
H202 
H202 

.30 


* OH 
= OH 
= OH 
= H2 
= OH 
= H20 

=2 . OOH 
= H202 

= H20 

= H202 

= OH 
= OH 


02 


.7 8 


OH 

O 

H 

02 

02 

02 

H 

HO 2 
02 
H20 
OH 

H20 


6.8E+13 
1 . 89E+14 
4 . 20E+14 
7 . 28E+13 
5 . OE+13 
8 . OE+12 
1 -34E+14 
7 . 9 1E+13 
6 . 1E+12 
1 . 8E+12 
7 . 8E+11 
1 .44E+17 


0 . 
0 . 
0. 

0 . 

0 . 

0 . 

0 . 

0 . 

0 . 

0 . 
0. 


6.0 


H202 



H2 

+ 

OH 


= H20 


+ 

H 

4.74E+13 0. 


H 

+ 

02 


= H02 


+ 

M 

1.46E+15 0. 


THIRDBODY 







02 

M 

1. 

.30 

H2 


3 . 0 


H20 

21.3 END 


+ 

H20 


= H 


+ 

OH 

1.30E+15 0. 


THIRDBODY 







H2 

H 

4 , 

. 00 

02 


1.5 


H20 

20.0 END 


+ 

0 


- OH 


+ 

M 

7.1E+18 -1 


M 


H2 


= H 


+ 

H 

2.2E+14 0. 


THIRDBODY 







H2 

M 

4 . 

, 10 

02 


2 . 0 


H20 

15.0 END 


+ 

02 


= O 


+ 

O 

1.80E+18 -1 


HNU 

+ 

H2 


>2 . OH 




.003 0. 


HNU 

+ 

02 


>2.00 




. 005 0 


end=1.0173, &end 


END 
TIME 

&prob rhocon= . true . , iprint=100, combus= . true . 

&start t=700.0, p=2.0 / &end 
H2 0.667 

02 0.333 

END 

&solver emax=1.0E-6, atolcp=l . 0E- 11 , &end 
FINIS 

LSENS METHANE AIR MECHAN . ; MON. DECR . TABULAR AREA WITH APRINT 
NEW 


CASE 14 

18365 . 
16400 . 
13750 . 
2126 . 
1000 . 

0 . 

107 0 . 
25000 . 
1430 . 

0 . 

0 . 

45510 . 

6 . 6 

6098 . 

- 1000 . 


105140 . 


0 . 

96000 . 


118020 . 
0 . 

0 . 


CASE 15 
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M 

4 

CH4 


CH3 

4 

H 

2 .0E417 

0 . 

88000. 

H 

4 

CH4 

= 

CH3 

4 

H2 

1.26E414 

0. 

11900. 

CH4 

4 

02 

= 

CH3 

4 

H02 

7 . 94E+13 

0. 

56000. 

0 

4 

CH4 

= 

CH3 

4 

OH 

1 .9E+14 

0. 

11720. 

OH 

4 

CH4 

= 

CH3 

4 

H20 

2 . 5E+13 

0 . 

5010. 

CH3 

4 

02 

= 

CH30 

4 

0 

2 . 4E+13 

0. 

28680 . 

CH3 

4 

OH 

= 

CH30 

4 

H 

6 . 3E+12 

0. 

0. 

M 

+ 

CH 30 

= 

CH20 

4 

H 

5 . OE+13 

0. 

21000. 

CH3 

4 

CH3 


C2H6 



2 . 4E+14 

- .4 

0 . 

H 

4 

C2H6 

= 

C2H5 

4 

H2 

1 .32E414 

0. 

9700 . 

0 

4 

C2H6 

= 

C2H5 

4 

OH 

1 .13E414 

0. 

7850 . 

OH 

4 

C2H6 

= 

C2H5 

4 

H20 

8 . 7E+13 

0. 

3520. 

M 

4 

C2H5 

= 

C2H4 

4 

H 

1 . OE+17 

0 . 

31000 . 

C2H5 

4 

02 

= 

C2H4 

4 

H02 

2 . OE+12 

0. 

5000. 

H 

4 

C2H5 


C2H4 

4 

H2 

4 . 8E+13 

0. 

0 . 

CH3 

4 

CH2 

= 

C2H4 

4 

H 

2 . OE+13 

0. 

0 . 

H 

4 

C2H4 

- 

H2 

4 

C2H3 

1.5E+14 

0. 

10200. 

M 

4 

C2H4 


C2H2 

4 

H2 

2 .6E+17 

0. 

79300. 

C2H4 

4 

OH 

- 

C2H3 

4 

H20 

4 . 8E+12 

0. 

1230 . 

C2H4 

4 

OH 

- 

CH3 

4 

CH20 

2. OE+12 

0. 

960 . 

C2H4 

4 

O 

S= 

CH3 

4 

HCO 

3.3E+12 

0. 

1130 . 

C2H4 

4 

O 

= 

CH20 

4 

CH2 

2.5E+13 

0. 

5000 . 

M 

4 

C2H3 


C2H2 

4 

H 

3 . 0E+ 15 

0. 

32000 . 

C2H3 

4 

02 

= 

CH20 

4 

HCO 

3 . 98E+12 

0. 

-250 . 

C2H3 

4 

H 

= 

C2H2 

4 

H2 

6 .OE+12 

0 . 

0 . 

C2H3 

4 

O 

= 

C2H20 

4 

H 

3 . 3E+13 

0 . 

0 . 

C2H3 

4 

OH 


C2H2 

4 

H20 

5 . OE+12 

0 . 

0. 

C2H3 

4 

CH2 

as 

C2H2 

4 

CH3 

3 .OE+13 

0 . 

0 . 

C2H3 

4 

C2H 

~2 

. 0C2H2 



3. OE+13 

0. 

0 . 

M 

4 

C2H2 

~ 

C2H 

4 

H 

4.2E+16 

0. 

107000 

C2H2 

4 

O 

= 

CH2 

4 

CO 

1.6E+14 

.0 

9890 . 

C2H2 

4* 

O 

= 

C2H0 

4 

H 

4 . OE+14 

0.0 

10660 . 

C2H2 

4 

OH 

=s 

C2H 

4 

H20 

6 . 3E+12 

0.0 

7000 . 

C2H2 

4 

OH 

= 

C2H20 

4 

H 

3 . 2E+11 

0.0 

200. 

C2H 

4 

02 

as 

C2H0 

4 

O 

5 . OOE+13 

0. 

1500. 

C2H 

4 

OH 

=s 

C2HO 

4 

H 

2 .OE+13 

0 . 

0 . 

C2HO 

4 

02 

= 2 . 

> OCO 

4 

OH 

1.46E+12 

0 . 

2500 . 

C2HO 

4 

0 

=2 . 

. OCO 

4 

H 

1 .202E+12 

0 . 

0 . 

C2HO 

4 

OH 

=2 . 

. OHCO 



1. OE+13 

0 . 

0 . 

C2HO 

4 

H 

= 

CH2 

4 

CO 

5. OE+13 

0 . 

0 . 

C2HO 

4 

CH2 

= 

C2H3 

4 

CO 

3. OE+13 

0 . 

0 . 

C2HO 

+ 

CH2 

= 

CH20 

4 

C2H 

1 .OE+13 

0 . 

2000 . 


2 , 

► OC2HO 

= 

C2H2 

42 , 

.OCO 

1. OE+13 

0 . 

0 . 

C2H20 

4 

OH 

= 

CH20 

4 

HCO 

2 . 8E+13 

0 . 

0. 

C2H20 

4 

OH 

= 

C2H0 

4 

H20 

7 . 5E+12 

0 . 

3000. 

C2H20 

4 

H 

~ 

CH3 

4 

CO 

1.13E+13 

0. 

3428. 

C2H20 

4 

H 

= 

C2H0 

4 

H2 

7 . 5E+13 

0 . 

8000. 

C2H20 

4 

0 

= 

C2H0 

4 

OH 

5 .OE+13 

0 . 

8000. 

C2H20 

4 

0 

= 

CH20 

4 

CO 

2 .OE+13 

0. 

0 . 

M 

4 

C2H20 

= 

CH2 

4 

CO 

2 . OE+16 

0 . 

60000 . 

C2H 

4 

0 

= 

CO 

4 

CH 

5 .OE+13 

0. 

0 , 

CH30 

4 

02 


CH20 

4 

H02 

1 . OE+13 

0. 

7170. 

CH30 

4 

H 

- 

CH20 

4 

H2 

2 .OE+13 

0 . 

0 . 

M 

4 

CH 20 

= 

HCO 

4 

H 

5 .OE+16 

0 . 

81000. 

CH20 

4 

OH 

= 

HCO 

4 

H20 

3 .OE+13 

0 . 

1200 . 

CH20 

4 

H 

= 

HCO 

4 

H2 

2 . 5E+13 

0. 

3990. 

CH20 

4 

O 

=5 

HCO 

4 

OH 

3 . 5E+13 

0. 

3510. 

CH3 

4 

CH20 

= 

CH4 

4 

HCO 

1.0E+10 

0.5 

6000. 

CH3 

4 

HCO 

= 

CH4 

4 

CO 

3.0E+11 

.5 

0. 

CH3 

4 

H02 

- 

CH30 

4 

OH 

2. OE+13 

0. 

0 . 

M 

4 

CH3 

= 

CH2 

4 

H 

1 .95E+16 

0. 

91600 . 

H 

4 

CH3 


H2 

4 

CH2 

2 . 7E+11 

.67 

25700 . 

O 

4 

CH 3 

- 

OH 

4 

CH2 

1 .9E+11 

.68 

25700. 

OH 

4 

CH3 

- 

H20 

4 

CH2 

2 . 7E+11 

.67 

25700 . 

CH 

4 

CO 2 

8S 

HCO 

4 

CO 

3 . 7E+12 

0. 

0 . 

CH 

4 

02 

as 

HCO 

4 

0 

1. OE+13 

0. 

0. 

CH2 

4 

02 

= 

CH20 

4 

0 

5 . OE+11 

0.5 

6960. 

CH2 

4 

0 

= 

CH 

4 

OH 

2.0E+11 

.7 

25800. 

CH2 

4 

OH 

- 

CH 

4 

H20 

5 .OE+11 

.5 

5900. 

CH2 

4 

H 


CH 

4 

H2 

3.2E+11 

0.7 

4970. 

CH2 

4 

CH2 

= 

C2H3 

4 

H 

5. OE+12 

0. 

0. 

CH2 

4 

CH2 

= 

C2H2 

4 

H2 

4. OE+13 

0. 

0. 

HCO 

4 

02 

= 

CO 

4 

H02 

3 .OE+13 

0. 

0 . 

HCO 

4 

0 

- 

CO 

4 

OH 

3. OE+13 

0. 

0 . 

HCO 

4 

OH 

- 

CO 

4 

H20 

3. OE+13 

0. 

0. 

HCO 

4 

H 

= 

CO 

4 

H2 

2 . OE+13 

0. 

0. 

M 

4 

HCO 

- 

H 

4 

CO 

2 . 9E+14 

0 . 

15570. 

CO 

4 

0 

= 

CO 2 

4 

M 

2.4E+15 

0 . 

4100. 

CO 

4 

02 


CO 2 

4 

O 

2 . 5E+12 

0. 

47690. 

CO 

4 

OH 

~ 

CO 2 

4 

H 

4 . 17E+11 

0. 

1000. 

CO 

4 

H02 

- 

CO 2 

4 

OH 

5 . 7 5E+13 

0. 

22930. 

o 

4 

H20 

= 

OH 

4 

OH 

6 . 8E+13 

0 . 

18365 . 
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H 

+ 

02 


« OH 

+ 

O 

1 .89E+14 

0 . 

16400 

O 

+ 

H2 


“ OH 

+ 

H 

4 . 2 OE+14 

0 . 

13750 

H 


HO 2 


= H2 

+ 

02 

7 . 28E+13 

0 . 

2126 . 

O 

+ 

HO 2 


= OH 

+ 

02 

5 . 0E+ 13 

0 . 

1000 . 

H02 

+ 

OH 


= H20 

+ 

02 

8 . 0E+ 12 

0 . 

0 . 

H 

♦ 

H02 


=2 . OOH 



1 . 34E+14 

0 . 

107 0 . 

H2 

+ 

H02 


= H202 

+ 

H 

7 . 9 1E+13 

0 . 

25000 , 

OH 

+ 

H202 


= H20 

+ 

H02 

6 . 1E+12 

0 . 

1430 . 

H02 

+ 

H02 


= H202 

+ 

02 

1 .8E+12 

0 . 

0 . 

H 

+ 

H202 


= OH 

+ 

H20 

7 . 8E + 11 

0 . 

0 . 

M 

+ 

H202 


~ 2 . OOH 



1 . 44E+ 17 

0 . 

45510 . 

THIRDBODY 









) 

2 

.30 

02 

.78 


H20 

6.0 H202 

6 .6 

H2 

+ 

OH 


= H20 

+ 

H 

4 .74E+ 1 3 

0 . 

6098 . 

H 

+ 

02 


= H02 

+ 

M 

1 . 4 6E+ 15 

0 . 

- 1000 . 

THIRDBODY 










1 , 

.30 

N2 

1 . 3 


H20 

21.3 CO 2 

7 . 0 

M 

+ 

H20 


= H 

♦ 

OH 

1 . 30E+15 

0 . 

1 0514 C 

THIRDBODY 










4 . 

, 00 

02 

1 . 5 


H20 

20.0 N2 


1 . 5 


4 . 

.0 

END 







H 

+ 

O 


= OH 

+ 

M 

7 . 1E+18 

-1 . 

0 . 

M 

+ 

H2 


= H 

+ 

H 

2 . 2E+14 

0 . 

96 000 

THIRDBODY 










4 . 

, 10 

02 

2 . 0 


H20 

15.0 N2 


2 . 0 


M 

+ 

02 

= 

O 

+ 

O 

1 . 80E+18 

-1 . 

118020 

CH 


N2 

= 

HCN 

+ 

N 

1 . 0E+11 

0 . 

19000 . 

CN 

+ 

H2 


HCN 

+ 

H 

6.0E+13 

0 . 

5300 . 

O 

+ 

HCN 

- 

OH 

+ 

CN 

1 .4E+11 

.68 

16900 . 

OH 

+ 

HCN 

= 

HNCO 

+ 

H 

4 . 0E+ 11 

0 . 

2800 . 

CN 

+ 

O 

= 

CO 

+ 

N 

1 .2E+13 

0 . 

0 . 

CN 

+ 

OH 

= 

NCO 

+ 

H 

2 . 5E+14 

0 . 

6000 . 

H2 

+ 

NCO 

= 

HNCO 

+ 

H 

1.0E+14 

0 . 

9000 . 

HNCO 

+ 

H 

- 

NH2 

+ 

CO 

1 .OE+14 

0 . 

8500 . 

CN 

+ 

02 

= 

NCO 

+ 

O 

3.2E+13 

0. 

1000 . 

CN 

+ 

C02 

= 

NCO 


CO 

3 .7E+12 

0 . 

0 . 

O 

+ 

NCO 

= 

NO 

+ 

CO 

2.0E+13 

0 . 

0 . 

N 

+ 

NCO 

= 

N2 

+ 

CO 

1.0E+13 

0 . 

0 . 

H 

♦ 

NCO 

* 

NH 

+ 

CO 

2 . 0E+ 13 

0 . 

0 . 

CH 

+ 

NO 

* 

N 

+ 

HCO 

1 .6E+13 

0 . 

9940 . 

CH 

+ 

NO 

= 

O 

+ 

HCN 

2 . 0E+12 

0 . 

0 . 

NH 

+ 

OH 

= 

N 

+ 

H20 

5 . 0E+11 

0.5 

2000 . 

H02 

+ 

NO 

= 

NO 2 

+ 

OH 

2 . 09E+12 

0 . 

-477 . 

O 

+ 

NO 2 

— 

NO 

+ 

02 

1 .0E+13 

0 . 

596 . 

NO 

+ 

O 

- 

NO 2 

+ 

M 

5 . 62E+15 

0 . 

- 1160 . 

NO 2 

+ 

H 

— 

NO 

+ 

OH 

3 . 47 E+14 

0 . 

147 0 . 

NO 

+ 

H 

= 

N 

+ 

OH 

2 . 63E+14 

0 . 

50410 . 

NO 

+ 

O 

= 

N 

+ 

02 

3 . 8E+9 

1 . 

4137 0 . 

O 

+ 

N2 

= 

NO 

+ 

N 

1 . 80E+14 

0 . 

76250 . 

N 

+ 

NO 2 

=2 . 

. ONO 



4 . OE+12 

0 . 

0 . 

M 

+ 

N20 

= 

N2 

+ 

O 

6 . 92E+23 

-2.5 

65000 . 

O 

4- 

N20 

= 

N2 

+ 

02 

1 . OE+14 

0 . 

28020 . 

O 

+ 

N20 

—2 . 

. ONO 



6 . 92E+13 

0 . 

26630 . 

N20 

+ 

H 

— 

N2 

+ 

OH 

7 . 59E+13 

0 . 

15100 . 

NO 2 

+ 

H2 

- 

HNO 2 

+ 

H 

2 . 4E+ 13 

0 . 

29000 . 

OH 

+ 

NO 2 

= 

HN03 

+ 

M 

3 . 0E+15 

0 . 

- 3 800 . 

THIRDBODY 










0 

.70 H2 


1 

.4 

END 




OH 

+ 

NO 

= 

HN02 

+■ 

M 

5 . 6E+ 1 5 

0. 

- 17 00 . 

HNO 

■f 

H 


H2 

+ 

NO 

5 . OE+12 

0 . 

0 . 

H 

+ 

NO 

* 

HNO 

+ 

M 

5 . 4E+15 

0 . 

- 600 . 

HNO 

+ 

OH 

= 

H20 

+ 

NO 

3 . 6E+ 13 

0 . 

0 . 


END 

DISTANCE AREA 

&prob Xtb= 0.0,5.0,10.0,15.0,20.0,25.0,30.0,32.0,34.0,36.0,38.0,40.0,42.0,44 0 
atb- 1200.0,1180.0,1160.0,1140.0,1120.0,1100.0,1080.0,1060.0,1040 0 1020 0 

1000.0, 980.0, 960.0, 940.0, ' " ' 

aprint = 1180.0, 1150., 1110., 950.0, &end 
&start t=16 00.0, mach=2.0, p=1.730, &end 
CH4 0.049768 

02 0.199072 

N2 0.75116 

CN 0.0000001 


emax=l . 0E- 5 , atolsp=l . 0E- 14 , tend 
WANE - AIR WITH TAB. AREA PROFILE OF CASE 15, 


BUT PRINT ASSIG; CASE 16 
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DISTANCE AREA „ A 

&prob xtb= 0 . 0 , 5 . 0 , 10 . 0,15. 0,20. 0,25. 0,30. 0,32. 0,34. 0,36. 0,38.0,40.0 

atb= 1200.0,1180.0,1160.0,1140.0,1120.0,1100.0,1080.0,1060.0,1040. 

. 0 , 980.0, 960.0, 940.0, 

5.0, 12.4954, 22.4363, 43.0002, &end 


1000 . 
print 
tetart 


t=16 00 . 0 , mach=2.0, p=1.7 30, &end 


5, atolep=l . 0E-14 , &end 


CH4 

0 . 049768 

02 

0 . 199072 

N2 

0.75116 

CN 

0 . 0000001 

END 


^solver 

emax=l . 0E- 

FINIS 



,42 .0,44 . 0, 
0 , 1020 . 0 , 
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APPENDIX E - SENSITIVITY TEST CASES 


In addition to the kinetics-only test cases described in appendix D we have prepared a set of 9 kinetics- 
plus-sensitivity analysis test cases. These example problems are also supplied with LSENS. The first six cases 
are constant-temperature problems whose results have been published in the literature. Results for cases I and 2 
were also computed analytically. Excellent agreement was obtained for all cases between the LSENS and litera- 
ture results. The last three cases are nonisothermal problems which illustrate the application of sensitivity anal- 
ysis to combustion problems. As for the kinetics-only test cases, all sensitivity cases are set up in one File for 
execution in a single computer run. Cases 1 , 2, 5, and 7 involve dummy species used in simple reactions. The 
thermodynamic data for these species are not read from the Standard Thermodynamic Data File. Their coeffi- 
cients are placed at the beginning of the Problem Data File. In this appendix we describe these cases. We then 
list the complete input file in table El. Cases 8 and 9 will be especially useful to users as models for their own 
sensitivity analysis computations. 


Description of Test Cases 


Case 1 


This is the constant-volume isothermal reaction A ~ B, where kj and k ,, the forward and reverse rate 

*-i 

coefficients, are given separately by writing the two separate irreversible reactions A -* B and B -> A. This 
case was first studied by Hwang (ref. 12) and later used by Radhakrishnan (ref. 13) to compare sensitivity anal- 
ysis methods. Note that in namelist PROB the variable SENSTD is set equal to TRUE, in addition to 
SENCAL. This action tells LSENS to compute sensitivity coefficients for the time derivatives of the dependent 
variables as well as for the variables themselves. The variable ALLSP is used after the key word INTT to ob- 
tain initial-value sensitivities with respect to all species and after the key word SENSVAR to obtain sensitivities 
for all species concentrations at each print station. In namelist SENRXN we have set AT T B YN equal to TRUE 
to obtain sensitivities with respect to all reactions. For this and all other isothermal reactions only the variable 
SENSAJ is set equal to TRUE for sensitivities with respect to the pre-exponential factors. Coefficients with 
respect to the temperature exponent and activation energy of any reaction will be the same as those for the pre- 
exponential factor. 


Case 2 

This is the constant-volume isothermal reaction A~ B'+C. Each forward and reverse reaction is written 
separately, so that the case has four reactions, A -» B, B -*■ A, B -» C, and C -» B. This test case was used 
by Hwang eL al. (ref. 14). The key word INIT does not appear in the sensitivity -analysis data, so no sensitivi- 
ties with respect to initial conditions are computed. 

Case 3 

This is the constant-volume isothermal pyrolysis of ethane using the mechanism of Kramer et al. (ref. 15). 
This same case was also used by Dunker (ref. 16) and Radhakrishnan (refs. 13 and 17) to compare sensitivity 
analysis methods. The data require sensitivities for all species with respect to the initial ethane concentration 
and temperature and for all species with respect to the rate coefficients of reactions 1 and 2. 

Case 4 

The isothermal constant-volume ignition of a methane-oxygen-argon mixture containing trace concentra- 
tions of carbon dioxide and hydrogen. The mechanism is that of Boni and Penner (ref. 18). Sensitivity coeffi- 
cients for all species with respect to all reaction preexponential coefficients are required. Separate forward and 
reverse rate coefficients are given for the reversible reactions. 
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Case 5 


This is the isothermal, constant volume oxidation of formaldehyde using the mechanism of Dougherty et al. 
(ref. 19). In this case the variable TINY is set equal to 0.1 in namelist PROB to set equal to zero any sensitivi- 
ty coefficients less than 0.1. Also, in namelist SENRXN the variable ORDER is set equal to TRUE, in order to 
have a second type of table printed out for the sensitivity coefficients. The second table is organized by depen- 
dent variable, and for each one the coefficients are listed in order of decreasing magnitude. The rate controlling 
reactions can then be seen at a glance. It should be noted that the chemical mechanism has two reactions which 
simulate the destruction of species at the wall of the reaction chamber. These are H 2 0 2 -» H 2 0 2 W and H0 2 
-» H0 2 W, where the species on the right hand side of each reaction has the same thermodynamic properties as 
the species on the left side. 

Case 6 

This problem is the isothermal, constant-volume oxidation of wet carbon monoxide. We use the mecha- 
nism of Yetter et al. (ref. 20). Sensitivity coefficients with respect to all rate parameters for the two variables 
hydrogen and carbon monoxide concentration are to be computed, as are sensitivities with respect to six initial 
concentrations. In namelist SENRXN we have set ORDER equal to TRUE and also set the variable OUTPUT 
equal to FALSE. This suppresses the printing of the standard type of sensitivity-coefficient table. Only the 
table organized by dependent variable is printed. 

Case 7 

This is the first nonisothermal case, the constant-pressure one-step reaction R -* P with the rate coeffi- 
cient expression 


k = LOT. 

This test problem, first used by Radhakrishnan (refs. 13 and 17), can be solved analytically and so permits an 
objective evaluation of the accuracy of the code. Sensitivity coefficients of all dependent variables and their 
derivatives are required. This is done very simply by placing the one word ALL on the line after the key word 
SENSVAR and setting the variable SENSTD equal to TRUE in namelist PROB. The word ALL is also placed 
after the key word INIT to obtain sensitivity coefficients with respect to the initial values of all dependent vari- 
ables. In namelist SENRXN we have set the variables SENSNJ and SENSEJ as well as SENSAJ equal to 
TRUE in order to obtain sensitivity coefficients with respect to all three rate-coefficient parameters in this 
nonisothermal reaction. 

Case 8 

This case is the constant-pressure static ignition of a stoichiometric hydrogen-air mixture seeded with 0.45 
mol % nitric oxide to catalyze the low initial-temperature (950.66 K) reaction. The mechanism is the same as 
that used for kinetics test case 2 and described in appendix D. Four reactions of carbon monoxide and carbon 
dioxide have also been added because the air contains a small amount of carbon dioxide. The latter reactions 
and rate coefficients are also taken from the kinetics test cases. The variable TINY is set to 1 .0x1(7 in 
namelist PROB. Sensitivity coefficients are required for seven dependent variables, six species concentrations 
and temperature. Initial value sensitivities are required for eight variables. Note that this list is ended by insert- 
ing a blank line because there are exactly eight names written on the line following the key word INIT. Rate 
coefficient sensitivities are to be computed for the six reactions whose numbers are listed in the array RXNUM 
in namelist SENRXN. 

Case 9 

This problem is the constant-volume static ignition of a stoichiometric benzene-oxygen mixture which has 
been shock-heated to an initial temperature of 1405 K. The chemical mechanism was developed by Bittker (ref. 
21) to match a wide range of experimental ignition delay times and composition profile data reported for this 
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fuel. Sensitivity coefficients for ten dependent variables are required, including temperature, density and pres- 
sure. Sensitivities with respect to the initial values of five variables, including temperature and density will be 
computed as well as sensitivities to the rate parameters Aj and Ej for 24 reactions listed in the array’ 
RXNUM. J 


TABLE El. - PROBLEM DATA FILE FOR SENSITIVITY ANALYSIS TEST CASES 


CARD 

300.000 1000.000 5000.000 

DUMA L 5/66A 1.00 0.00 0.00 0.G 300.000 5000 

0.25 16 147 4E 01 0.00000000 0.00000000 0.00000000 

0.00000000 0.00000000 0 . 2 516147 4E 01 0.00000000 

0.00000000 0.00000000 0.00000000 0.00000000 

L 5/6 6 A 1.00 0.00 0.00 0.G 300.000 5000 

0.25 16 147 4E 01 0.00000000 0.00000000 0.00000000 

0.00000000 0.00000000 0 . 2 516147 4 E 01 0.00000000 

0.00000000 0.00000000 0.00000000 0.00000000 

DUMC L 5/66A 1.00 0.00 0.00 0.G 300.000 5000 

0 . 2 516147 4E 01 0.00000000 0.00000000 0.00000000 

0.00000000 0.00000000 0 . 2 516147 4E 01 0.00000000 

0.00000000 0.00000000 0.00000000 0.00000000 

DUMP L 5/66A 1.00 0.00 0.00 0.G 300.000 5000 

0.25161474E 01 0.00000000 0.00000000 0.00000000 

-0.25161474E 04 0.00000000 0.25161474E 01 0.00000000 

0.00000000 0. 00000000-0. 25161474E 04 0.00000000 

DUMR L 5/66A 1.00 0.00 0.00 0.G 300.000 5000 

0 . 25 16147 4E 01 0.00000000 0.00000000 0.00000000 

0.00000000 0.00000000 0 . 2 516147 4E 01 0.00000000 

0.00000000 0.00000000 0.00000000 0.00000000 

H ° 2W J 9/78H 1.0 2. 0. 0.G 300.000 5000 

0.4017 3 06 0E 01 0 . 2 2 17 5 8 83 E - 02 - 0 . 57 7 1017 IE - 06 0 . 7 137 2 882E- 1 0 - ( 
-0.1141 24 45E 04 0.37846051E 01 0.35964102E 01 0 . 5 2 5 007 4 8E- 03 ( 


.000 1.0 1 

0.00000000 2 

0.00000000 3 

0.00000000 4 

.000 1.0 1 

0.00000000 2 

0.00000000 3 

0.00000000 4 

.000 1.0 1 

0.00000000 2 

0.00000000 3 

0.00000000 4 

• 000 1.0 1 
0.00000000 2 

0.00000000 3 

0.00000000 4 

.000 l.o 1 

0.00000000 2 

0.00000000 3 

0.00000000 4 

.000 33.00669 1 


- w . j Ui U . / U j 

-0.95674952E 08 0 . 3 6597 628E- 11 - 0 . 89333502E 03 0.66372671E 01 
H202W L 3/85H 2.0 2. 0. 0.G 300.000 5000 

0 . 47 92 8858E 01 0 . 36 3 0086 5E- 02 - 0 . Ill 364 3 5E - 05 0 . 14868513E- 09 - 

- 0 . 1 81 32195E 05-0.51306415E 00 0.34546633E 01 0 . 5557 5930E- 02 

- 0 . 4 627 97 80E- 08 0 . 2 14 5 82 00E- 11 - 0 . 17 67 23 2 8E 05 0.68402452E 01- 

C DP/' ^ t J 


SPECA L 5/6 6 A 1.00 0.00 0.00 0.G 300.000 5000 

0 . 25161474E 01 0.00000000 0.00000000 0.00000000 

0.00000000 0.00000000 0 . 25 16 1474E 01 0.00000000 

0.00000000 0.00000000 0.00000000 0.00000000 

SPECB L 5/66A 1.00 0.00 0.00 0.G 300.000 5000 

0.25161474E 01 0.00000000 0.00000000 0.00000000 

0.00000000 0.00000000 0. 2516147 4E 01 0.00000000 

0.00000000 0.00000000 0.00000000 0.00000000 

END 

SIMPLE TEST CASE A=B : HWANG, JT, PROC . NSC TAIWAN PART B V6 
SPECA > SPECB 1 . OOE+O 3 

SPECB > SPECA 1 . 00E+00 


300.000 5000 

0 . 00000000 
0 . 00000000 
0 .00000000 
300.000 5000 

0 . 00000000 
0 . 00000000 
0 . 00000000 


SPECA 

SPECB 


0 .36458591E- 14 2 

0 .75118344E-05 3 

0.00000000 4 
. 000 34 . 01460 1 

0 . 6 895 8511E - 14 2 

0 .92103738E- 06 3 

0 . 16 394994E 05 4 

.000 0 . 999 0 01E - 03 1 
0.00000000 2 
0.00000000 3 
0.00000000 4 

.000 0 . 999001E - 03 1 
0.00000000 2 
0.00000000 3 

0.00000000 4 

, P37 , 1982 . CASE 1 


TIME 

&prob rhocon=. true . , tcon= . true . , eencal=.true 
print=l . 5E - 04 , 1 . 0E - 03 , 2 . 0E- 02 , &end 
fcstart p=i.o, t=300.0, &end 
SPECA 0.999001 

SPECB 0.000999 

END 

Stsol ver emax=l . 0E-06 , atolsp=0.0, tend 

INIT 

ALLS P END 

SENSVAR 
ALLS P END 

REAC 

&senrxn seneaj = . true . , allrxn= . true . , &end 
FINIS 

SIMPLE TEST CASE A=B=C : HWANG ET AL, J. CHEM PHYS , 


emax=i . 0E - 06 , atolsp=0.0. 


seneaj=. true . , allrxn= . true . , 


senstd— . true . , 


V69, P5180, 
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&prob rhocon= . true . , tcon=.true., sencal= . true . , 
print= 0.1, 2.5, 4.5, tend 
&start t=3 00.0, p=1.0, &end 
DUMA 1.00 

END 

isolver emax=l . 0E- 6 , atolsp=l . 0E- 8 , &end 
SENS VAR 
ALLS P END 

REAC 

&senrxn allrxn= . true . , seneaj= , true . , &end 
FINIS 

ETHANE PYROLYSIS: KRAMER ET AL, APPL MATH MODELLING, V5 , P432, 1981. CASE 3 
NEW 




C2H6 

>2 

0CH3 



1 . 2 0E+1 2 

0.0 

59218.0 

C2H6 

+ 

CH3 

> 

C2H5 

+ 

CH4 

8 . 01E+08 

0.0 

11943.0 



C2H5 

> 

C2H4 

+ 

H 

3 . 00E+11 

0.0 

34974 . 0 

H 

+ 

C2H6 

> 

C2H5 

+ 

H2 

1 .30E+11 

0.0 

8982.0 

H 

+ 

H 

> 

H2 



6 . 99E+13 

0.0 

0.0 


TIME 

&prob rhocon= . true . , tcon=.true. , sencal= . true . , 
print= l.o, 20.0, &end 
&start p=0 .4507, t=923 . 0 , &end 

C2H6 1 . 0 

END 


fcsolver emax=l . OE-6 , atolsp=l . 0E- 8 , tend 
INIT 

C2H6 TEMP END 

SENSVAR 

ALLS P END 

REAC 


&senrxn 8eneaj= . true . , rxnum =1,0, 2.0, &end 
FINIS 


CH4 -02-AR 

SHOCK IGNITION: 

BONI & 

PENNER 

, COMB SCI 

& TECH, V15 , 

P99 , 

1977 . CASE 4 

NEW 










M 

+ 

CH4 

> 

CH3 

+ 

H 

4.337 E+07 

0.0 

0.0 

H 

+ 

CH3 

> 

CH4 

+ 

M 

1 . 106E+17 

0.0 

0.0 

OH 

+ 

CH4 

> 

CH3 

+ 

H20 

2 . 59 0E+13 

0.0 

0.0 

CH3 

+ 

H20 

> 

OH 

+ 

CH4 

1.048E+11 

0.0 

0.0 

H 

+ 

CH4 

> 

CH3 

+ 

H2 

1 . 988E + 13 

0.0 

0.0 

CH3 

+ 

H2 

> 

H 

+ 

CH4 

8.071E+11 

0.0 

0.0 

O 

+ 

CH4 

> 

CH3 

+ 

OH 

2 . 16 8E+12 

0.0 

0.0 

CH3 

+ 

OH 

> 

O 

+ 

CH4 

6 . 625E+10 

0.0 

0 . 0 

CH3 

+ 

O 

> 

CH20 

+ 

H 

1.0E+14 

0.0 

0 . 0 

CH20 

+ 

H 

> 

CH3 

+ 

O 

5.3E+07 

0.0 

0.0 

CH3 

+ 

02 

> 

CH20 

+ 

OH 

2.0E+10 

0.0 

0.0 

CH20 

+ 

OH 

> 

CH3 

+ 

02 

4 . 337E+04 

0 . 0 

0 . 0 

CH20 

+ 

O 

> 

HCO 

+ 

OH 

1 . 584E+13 

0.0 

0 . 0 

HCO 

+ 

OH 

> 

CH20 

+ 

O 

9 . 035E+09 

0.0 

0.0 

CH20 

+ 

OH 

> 

HCO 

+ 

H20 

1 .108E+14 

0.0 

0 . 0 

HCO 

+ 

H20 

> 

CH20 

+ 

OH 

8 . 553E+09 

0.0 

0 . 0 

CH20 

+ 

H 

> 

HCO 

+ 

H2 

5 . 24 OE+12 

0.0 

0.0 

HCO 

+ 

H2 

> 

CH20 

+ 

H 

4 . 216E+09 

0.0 

0 . 0 

M 

+ 

CH 20 

> 

HCO 

+ 

H 

3 . 843E+08 

0.0 

0.0 

HCO 

+ 

H 

> 

CH20 

+ 

M 

1 . 959E+16 

0.0 

0 . 0 

HCO 

+ 

O 

> 

CO 

+ 

OH 

1.0E+14 

0.0 

0.0 

CO 

+ 

OH 

> 

HCO 

+ 

O 

1 . 144E+05 

0.0 

0.0 

HCO 

+ 

OH 

> 

CO 

+ 

H20 

1 .OE+14 

0.0 

0.0 

CO 

+ 

H20 

> 

HCO 

+ 

OH 

1 .265E+04 

0.0 

0 . 0 

HCO 

+ 

H 

> 

CO 

+ 

H2 

2 .OE+14 

0.0 

0 . 0 

CO 

+ 

H2 

> 

HCO 

+ 

H 

2 .77 1E+05 

0.0 

0.0 

M 

+ 

HCO 

> 

H 

+ 

CO 

4 . 216E+10 

0.0 

0.0 

H 

♦ 

CO 

> 

HCO 

+ 

M 

3 . 628E+12 

0.0 

0.0 

CO 

+ 

OH 

> 

CO 2 

+ 

H 

5 . 360E+11 

0.0 

0.0 

CO 2 

•f 

H 

> 

CO 

+ 

OH 

2 . 289E+11 

0.0 

0.0 

H2 

■f 

OH 

> 

H20 

+ 

H 

1 . 807E+13 

0.0 

0.0 

H20 

+ 

H 

> 

H2 

+ 

OH 

1 . 807E+12 

0.0 

0.0 

O 

+ 

H2 

> 

OH 

+ 

H 

7 . 228E+12 

0.0 

0.0 

OH 

+ 

H 

> 

0 

+ 

H2 

6 . 625E+12 

0.0 

0.0 

H 

+ 

02 

> 

OH 

+ 

O 

3 . 216E+12 

0.0 

0.0 

OH 

+ 

O 

> 

H 

+ 

02 

1. 385E+13 

0.0 

0 . 0 

H 

+ 

OH 

> 

H20 

+ 

M 

2 . 104E+15 

0.0 

0 . 0 

THIRDBODY 









H20 

16 .7 


END 







M 

+ 

H20 

> 

H 

+ 

OH 

3 . 096E+03 

o 

o 

o 

o 

THIRDBODY 









H20 

16 .7 


END 







H 

+ 

HO 2 

>2 

. OOH 



1 .554E+14 

0.0 

0.0 


2 . 

OOH 

> 

H 

+ 

H02 

6 . 023E+08 

0.0 

0.0 

H 

+ 

02 

> 

H02 


M 

1 .930E+15 

0.0 

0.0 

M 

+ 

HO 2 

> 

H 

+ 

02 

2 .168E+10 

0 . 0 

0.0 
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OH 

+ 

OH 

> 

O 

+ 

H20 

9 . 4 56E+ 12 

0.0 

O 

+ 

H20 

> 

OH 


OH 

1 . 205E+ 12 

0 . 0 

AR 









TIME 









&prob 

rhocon= . true . 

, tcon= . true 

. , sencal=.true 

. , print= 2 . 

5E-5, 

&end 









&start 

t=2 000 . 0 , p=6 . 

729 

, &end 





CH4 

0 . 

09172 







02 

0. 

18344 







AR 

0 

72484 







CO 2 


4 . 0494E- 

20 






H2 


4 . 04 94 E - 

20 






END 









&solver 

mf ; 

=21, emax-1 

. OE 

-3, atolsp=l 

. 0E-12, &end 


SENS VAR 









ALLS P 

END 







REAC 









isenrxn 

sensaj= . true 

allrxn=.true 

. , &end 



FINIS 









FORMALDEHYDE 

OX ID . : DOUGHERTY ET AL, 

, J 

. CHEM PHYS, 

V7 1 , P1794, 

1979 

NEW 









HCO 

+ 

02 

> 

CO 

+ 

H02 

6 . 02E+10 

0 . 

H02 

+ 

CH20 

> 

H202 

+ 

HCO 

3 . 43E+10 

0. 

M 

♦ 

H202 

>2 

. OOH 



4 . 01E+ 06 

0 . 

0H2O 

+ 

OH 

> 

HCO 

+ 

H20 

9 .64E+13 

0 . 

OH 

+ 

H202 

> 

H20 

+ 

H02 

3 . 07E+12 

0 . 



H202 

> 

H202W 



1 . 05E+2 

0 . 



HO 2 

> 

H02W 



1 . 05E+1 

0 . 

H02 

+ 

HO 2 

> 

H202 

+ 

02 

1 . 8 1E+ 12 

0 . 

CO 

+ 

OH 

> 

CO 2 

+ 

H 

1 -99E+11 

0 . 

CO 

+ 

H02 

> 

CO 2 

+ 

OH 

7 . 23E + 08 

0 . 

CH20 

+ 

H 

> 

HCO 

+ 

H2 

1 -63E + 12 

0 . 

H 

+ 

02 

> 

OH 

+ 

0 

3 . 32E+10 

0 . 

H 

+ 

02 

> 

H02 

+ 

M 

3.63E+15 

0 . 

M 

+ 

HO 2 

> 

H 

+ 

02 

2 . 83E+05 

0 . 

O 

+ 

H2 

> 

OH 

+ 

H 

1 .82E+11 

0 . 

CH20 

+ 

0 

> 

HCO 

♦ 

OH 

6 . 02E + 13 

0. 

H 

+ 

H202 

> 

H02 

+ 

H2 

7 .83E + 11 

0 . 

H 

♦ 

H202 

> 

H20 

+ 

OH 

3 . 55E + 12 

0 . 

O 

+ 

H202 

> 

OH 

+ 

H02 

6 . 02E + 10 

0 . 



HCO 

> 

H 

+ 

CO 

4 . 6 OE- 12 

0 . 

H2 


OH 

> 

H20 

+ 

H 

6 . 02E+1 2 

0. 

CH20 

+ 

02 

> 

HCO 

+ 

H02 

1 .75E+04 

0 . 

H 

+ 

HO 2 

>2 

.OOH 



3 .01E+12 

0 . 

H02 

+ 

H 

> 

H20 

+ 

0 

3 . 01E+13 

0 . 

H 

+ 

H02 

> 

H2 

+ 

02 

2 .71E+13 

0 . 


0.0 
0 . 0 


CASE 5 


0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 
0 . 


N2 

TIME 

&prob rhocon- . true . , tcon= . true . , sencal= . true . , 
print= 1 . 0E- 06 , 5 . OE- 03 , &end 
&start t=952.0, p=0. 918066, &end 
CH20 0.009564 

CO 0.399833 

02 0.179453 

N2 0.411150 

END 


&solver emax=l. 0E-06, atolsp=l . 0E- 08 , &end 
SENS VAR 
ALLS P END 

REAC 


tiny=0 . 1 , 


&senrxn allrxn= . true . , 8ensaj= . true . , order= . true . , &end 
FINIS 

WET CO OXIDATION: YETTER ET AL, COMB & FLAME, V59, PI 07 , 1985. 
NEW 


CASE 6 


HCO 

+ 

H 

> 

CO 


H2 

2 . OE+14 

0 . 

0 

CO 

+ 

H2 

> 

HCO 

+ 

H 

1 .716E-3 

0. 

0 

HCO 

+ 

OH 

> 

CO 

+ 

H20 

1 .OE+14 

0 . 

0 

CO 

+ 

H 20 

> 

HCO 

+ 

OH 

3 . 656E- 06 

0 . 

0 

HCO 

+ 

0 

> 

CO 

+ 

OH 

3 . 012E+ 13 

0. 

0 

CO 

+ 

OH 

> 

0 

+ 

HCO 

2 . 867 E - 04 

0 . 

0 

HCO 

+ 

02 

> 

CO 

+ 

H02 

3 . 015 E + 12 

0 . 

0 

CO 

+ 

H02 

> 

HCO 

+ 

02 

2 . 59 0E + 06 

0 . 

0 

CO 

+ 

H02 

> 

CO 2 

+ 

OH 

3 . 084E+09 

0 . 

0 

C02 

+ 

OH 

> 

CO 

+ 

H02 

1 .777E-02 

0 . 

0 

CO 

+ 

OH 

> 

CO 2 

+ 

H 

1 .921E+11 

0 . 

0 

C02 

+ 

H 

> 

CO 

+ 

OH 

7 . 89 0E+ 08 

0 . 0 

0 

CO 2 

♦ 

0 

> 

CO 

+ 

02 

4 . 434E+ 02 

0 . 

0 

CO 

♦ 

02 

> 

CO 2 

+ 

0 

8 . 49 2E+ 02 

0 . 

0 

H 

4- 

02 

> 

OH 

+ 

0 

1 . 126E+11 

0 . 

0 

OH 

+ 

O 

> 

H 

+ 

02 

1 . 3 85E + 1 3 

0 . 

0 



O 

+ 

H2 

> 

OH 

+ 

H 

3 . 3 85E+11 

0. 

0 . 

OH 

+ 

H 

> 

O 


H2 

3 . 831E+11 

0.0 

0.0 

O 

+ 

H20 

> 

OH 

+ 

OH 

1 . 650E+10 

0. 

0 . 

OH 

+ 

OH 

> 

O 

+ 

H20 

4 . 108E+12 

0. 

0.0 

H20 

+ 

H 

> 

OH 

+ 

H2 

7 .7 09E+09 

0 . 

0 . 

OH 

+ 

H2 

> 

H20 

+ 

H 

1 .837E+12 

0. 

0.0 

OH 

+ 

H202 

> 

H20 

+ 

H02 

3 . 6 32E+12 

0 . 

0 . 

H20 

+ 

H02 

> 

OH 

+ 

H202 

7 .107E+06 

0 . 

0 . 0 

O 

+ 

HO 2 

> 

OH 

+ 

02 

2 . 168E+ 13 

0 . 

0 . 

OH 

+ 

02 

> 

0 

+ 

H02 

2.47 5E+ 02 

0. 

0 . 0 

H 

+ 

H02 

>2 

OOH 



1 .126E+14 

0. 

0.0 

OH 

+ 

OH 

> 

H 

+ 

H02 

1 .385E+05 

0. 

0.0 

H 

+ 

HO 2 

> 

H2 

+ 

02 

2 . 506E+13 

0 . 

0 . 0 

H2 

+ 

02 

> 

H 

+ 

H02 

2 . 4 87 E+ 02 

0. 

0 . 0 

H02 

+ 

OH 

> 

H20 

+ 

02 

1 .313E+13 

0. 

0.0 

H20 

+ 

02 

> 

H02 

+ 

OH 

5 . 529E- 01 

0. 

0 . 0 

02 

+ 

H202 

>2 

0HO2 



1 .349E+05 

0. 

0.0 

H02 

+ 

H02 

> 

02 

+ 

H202 

6 . 3 24E+12 

0. 

0.0 

H02 

+ 

H2 

> 

H202 

+ 

H 

1 . 4 03E+08 

0. 

0 . 

H202 

+ 

H 

> 

H02 


H2 

3 . 054E+11 

0. 

0.0 

M 

+ 

02 

> 

0 

+ 

0 

2 . 030E-08 

0 . 

0. 

O 

+ 

O 

> 

02 

+ 

M 

1 . 861E+14 

0 . 

0.0 

M 

+ 

H2 

> 

H 

+ 

H 

1 .850E-05 

0 . 

0. 

H 

+ 

H 

> 

H2 

+ 

M 

3 . OOOE+15 

0 . 

0.0 

M 

+ 

OH 

> 

0 

+ 

H 

1 . 807 E- 04 

0 . 

0. 

O 

+ 

H 

> 

OH 

+ 

M 

1 .001E+16 

0 . 

0 . 0 

M 

+ 

H202 

>2 

. OOH 



1 . 090E+08 

0 . 

0 . 

OH 

+ 

OH 

> 

H202 

+ 

M 

9 . 251E+15 

0. 

0 . 0 

M 

+ 

H20 

> 

H 

+ 

OH 

3 . 012E-05 

0.0 

0 . 

H 

+ 

OH 

> 

H20 

+ 

M 

1 .157E+17 

0.0 

0 . 0 

M 

+ 

HO 2 

> 

H 

+ 

02 

1 .7 53E+06 

0 . 

0 . 

H 

+ 

02 

> 

H02 

+ 

M 

2 . 6 05E+15 

0. 

0.0 

M 

+ 

CO 2 

> 

CO 

+ 

0 

3 .234E-08 

0. 

0. 

CO 

+ 

0 

> 

CO 2 

+ 

M 

9 . 069E+14 

0.0 

0.0 

M 

+ 

HCO 

> 

H 

+ 

CO 

2 .777E+10 

0. 

0 . 

H 

+ 

CO 

> 

HCO 

+ 

M 

3 . 2 10E+14 

0. 

0.0 


N2 

TIME 

tprob rhocon= . true . , tcon= . true . , Bencal= . true . , 
print=l . OE-4, 1 . 0E~ 1 , 1 . 0E2 , tend 
ScStart t=1100.0, p=1.0, &end 
CO 0.002 

H20 0.01 

02 0.028 

N2 0.96 

END 

&solver emax=1.0E-3, atolsp=l . 0E- 12 , tend 
SENS VAR 
CO H2 

END 
INIT 

HCO H OH O H02 H202 END 

REAC 

&senrxn Bensaj= . true allrxn= . true . , output= . false . , order= . true . , 

&end 

FINIS 

SIMPLE NONISOTHERMAL TEST CASE R>P CASE 7 

NEW 

DUMR > DUMP 1.0 1.0 0.0 


TIME PRESSURE 

&prob pcon= . true . , sencal= . true . , senstd^ . true . , 
print=l . 0E- 06 , 1 . 0E - 04 , 1 . 0E- 02 , tend 
&start t=1000 . 0 , p=l . 0 , tend 
DUMR 1.00 

END 

teolver emax=1.0E-3, atolsp=l . 0E- 12 , &end 
INIT 

ALL END 

SENS VAR 
ALL END 

REAC 

isenrxn sensaj^ . true . , sensnj = . true . , sense j= . true . , allrxn= . true . , 
&end 
FINIS 


HYDROGEN 

COMBUSTION 

IN STANDARD 

AIR 

AT 3.10 ATM . 



CASE 8 

NEW 

CO 

+ 

0 

= CO 2 

+ 

M 

5 . 888E+15 

0 . 

4100 . 

CO 

+ 

02 

= CO 2 

+ 

O 

2 . 512E+12 

0. 

47690 . 

CO 

+ 

OH 

= CO 2 

+ 

H 

4 . 169E+11 

0. 

1000. 
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CO 

+ 

H02 


= 

CO 2 

+ 

OH 

5 . 7 54 E + 13 

0 . 

22930. 

0 

+ 

H20 


= 

OH 

+ 

OH 

6 . 8E + 1 3 

0 . 0 

18365 , 

H 

+ 

02 


- 

OH 

+ 

0 

1 .89E+14 

0 . 

16400 . 

o 

+ 

H2 


= 

OH 

+ 

H 

4 . 20E+ 14 

0 . 

13750 . 

H 

+ 

HO 2 


= 

H2 

+ 

02 

7 . 28E+13 

0 . 

2126 . 

O 

+ 

HO 2 


= 

OH 

+ 

02 

5 . 0E+13 

0 . 

1000 . 

H02 

+ 

OH 


= 

H20 

+ 

02 

8 . OE+12 

0 . 

0 . 

H 

+ 

H02 


=2 

. OOH 



1 .34E+14 

0 . 

107 0 . 

H2 

+ 

H02 


= 

H202 

+ 

H 

7 . 91E+13 

0 . 

25000 . 

OH 

+ 

H202 


= 

H20 

+ 

H02 

6 . 1E+12 

0 . 

1430 . 

H02 

+ 

H02 


= 

H202 

♦ 

02 

1.8E+12 

0 . 

0 . 

H 

+ 

H202 


- 

OH 

+ 

H20 

7 . 8E+11 

0. 

0 . 

M 

+ 

H202 


= 2 

. OOH 



1 .44E+17 

0 . 

45510. 

THIRDBODY 










H2 

2 

.30 

02 


.78 


H20 

6.0 H202 

6 . 6 

END 











H2 

+ 

OH 


= 

H20 

+ 

H 

4 . 7 4E+13 

0 . 

6098 . 

H 

+ 

02 


5C 

H02 

+ 

M 

1 .46E+15 

0 . 

- 1000 . 

THIRDBODY 










02 

1 

.30 

N2 


1 . 3 


H20 

21.3 H2 


5 . 0 

END 











M 


H20 


- 

H 

+ 

OH 

1.30E+15 

0 . 

105140 

THIRDBODY 










H2 

4 

. 00 

02 


1 . 5 


H20 

20.0 N2 


1 . 5 

END 











H 

+ 

0 


= 

OH 

+ 

M 

7 . 1E+18 

-1 . 

0 . 

M 

+ 

H2 


* 

H 

+ 

H 

2 . 2E+14 

0 . 

96000 

THIRDBODY 










H2 

4 

.10 

02 


2 . 0 


H20 

15.0 N2 


2 . 0 

END 











M 

+ 

02 


=S 

0 

+ 

0 

1 . 80E+18 

*1 . 

118020 

H02 

+ 

NO 


= 

NO 2 

+ 

OH 

2.09E+12 

0 . 0 

-477 . 

O 

+ 

NO 2 


= 

NO 

+ 

02 

1 .0E+13 

0 . 0 

596 . 

NO 

+ 

0 


- 

NO 2 

+ 

M 

5 . 62E+15 

0 . 

- 1160 . 

N02 


H 



NO 

+ 

OH 

3 . 47E+14 

0 . 

1470 . 

NO 

+ 

O 


= 

N 

+ 

02 

3 . 8E+9 

1 . 0 

4137 0 . 

O 

+ 

N2 


= 

NO 

+ 

N 

1 .8E+14 

0. 

76250 . 

NO 

+ 

H 


= 

N 

+ 

OH 

2 . 63E+14 

0 . 

50410 . 

M 

+ 

N20 


= 

N2 

+ 

0 

6 . 92E+23 

-2.5 

65000 . 

O 

+ 

N20 


= 

N2 

+ 

02 

1.0E+14 

0 . 

28020 . 

0 

+ 

N20 


=2 . 

. ONO 



6 . 92E+1 3 

0 . 

26630 . 

N 

+ 

NO 2 


=2 . 

. ONO 



4. OE+12 

0. 

0 . 0 

N20 

♦ 

H 


= 

N2 

+ 

OH 

7 . 59E+1 3 

0 . 

15100 . 

NO 2 

♦ 

H2 


= 

HN02 

+ 

H 

2 . 4E+13 

0 . 

29000 . 

OH 

+ 

NO 2 


= 

HNO 3 

+ 

M 

3 . 0E+15 

0 . 

-3800 . 

THIRDBODY 










02 

0 . 

.7 0 

H2 


1 .4 


END 




OH 

+ 

NO 


= 

HN02 

+ 

M 

5 . 6E+15 

0 . 

- 17 00 . 

HNO 

+ 

H 


= 

H2 

+ 

NO 

5 .OE+12 

0. 

0 . 

H 

+ 

NO 


= 

HNO 

+ 

M 

5 . 4E+15 

0 . 

-600 . 

HNO 


OH 


= 

H20 

4 

NO 

3 .6E+13 

0 . 

0 . 


AR 

TIME PRESSURE 

tprob sencal= . true . , tiny=1.0E-7, 


print= 

1.0E-4, 1.8E-4, 

2 . OE-4 , 

ct 0=3.1, tend 



&start 

t= 950.66, &end 




H2 

0 . 2952726 





02 

0 . 1476404 





CO 2 

2 . 1 14 0E - 4 





N2 

0.5458075 





NO 

0 . 0045 





AR 

6 . 5681E-3 





END 






ficsolver 

emax= 1.0E-4, 

atolsp= 1 

.OE-13, &end 



INIT 






CO 

H2 02 

H02 

H202 

NO TEMP 

DENSITY 

REAC 






&8enrxn 

eensaj= . true . , 

sensej= . 

true., output= . 

false., order=.true. 


rxnum=5 . 

.0,6 .0, 8.0, 11.0, 

17 . 0, 18 . 0 

, tend 



SENS VAR 






CO 

CO 2 OH 

H20 

H2 

NO TEMP 

END 

FINIS 






BENZENE - 

■ OXYGEN AR SHOCK 

IGNITION 

- WITH SENSITIVITY MECHANISM K-70 

CASE 9 

NEW 






C6H6 

+ 02 

C6H50 

+ OH 

4.0E+13 0. 

34000 . 

C6H6 

+ C6H5 

C12H10 

+ H 

4.0E+11 0. 

4000 . 


C6H6 

C6H5 

+ H 

1.0E+16 0. 

108000 

C6H6 

+ H 

C6H5 

+ H2 

2.5E+14 0. 

16000 . 

C6H6 

+ 0 

C6H50 

+ H 

2 . 7 83E+13 0. 

4910. 

C6H6 

+ OH 

C6H5 

+ H20 

2 . 132E+13 0. 

4580. 
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M 

+ 

C4H3 

= C4H2 

+ 



C6H50 

= C5H5 

+ 

C6H5 

+ 

02 

= C6H50 

+ 

C6H5 

+ 

H02 

= C6H50 

+ 



C6H5 

= C4H3 

+ 



C6HSOH 

= C6H50 


C6H50H 

+ 

H 

= C6H6 

+ 

C6H50H 

+ 

H 

= C6H50 

+ 

C5H5 

+ 

C6H50H 

= C6H50 

+ 



C5H6 

= C5H5 

+ 

C5H6 

+ 

02 

= C5H50 

+ 

C6H50H 

+ 

OH 
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